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(57) A programming interface for a computer plat- 
form can include various functionality. In certain embod- 
iments, the programming interface includes one or more 
of the following groups of types or functions: those re- 
lated to core file system concepts, those related to en- 
tities that a human being can contact, those related to 
documents, those common to multiple kinds of media, 
those specific to audio media, those specific to video 
media, those specific to image media, those specific to 
electronic mail messages, and those related to identify- 
ing particular locations. 
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Description 
TECHNICAL FIELD 

5 [0001 ] This invention relates to software and to development of such software. More particularly, this invention relates 
to a programming interface that facilitates use of a software platform by application programs and computer hardware. 

BRIEF DESCRIPTION OF ACCOMPANYING COMPACT DISCS 

10 [0002] Accompanying this specification is a set of three compact discs that stores a Software Development Kit (SDK) 
for the Microsoft® Windows® Code-Named "Longhorn" operating system. The SDK contains documentation for the 
Microsoft® Windows® Code-Named "Longhorn" operating system. Duplicate copies of each of these three compact 
discs also accompany this specification. 

[0003] The first compact disc in the set of three compact discs (CD 1 of 3) includes a file folder named "Ihsdk" that 
15 was created on October 22, 2003; it is 586 Mbytes in size, contains 9,692 sub-folders, and contains 44,292 sub-files. 
The second compact disc in the set of three compact discs (CD 2 of 3) includes a file folder named "ns" that was 
created on October 22, 2003; it is 605 Mbytes in size, contains 1 2,628 sub-folders, and contains 44,934 sub-files. The 
third compact disc in the set of three compact discs (CD 3 of 3) includes a file folder named "ns" that was created on 
October 22, 2003; it is 575 Mbytes in size, contains 9,881 sub-folders, and contains 43,630 sub-files. The files on each 
20 of these three compact discs can be executed on a Windows®-based computing device (e.g., IBM-PC, or equivalent) 
that executes a Windows®- brand operating system (e.g., Windows® NT, Windows® 98, Windows® 2000, Windows® 
XP, etc.). The files on each compact disc in this set of three compact discs are hereby incorporated by reference. 
[0004] Each compact disc in the set of three compact discs itself is a CD-R, and conforms to the ISO 9660 standard. 
The contents of each compact disc in the set of three compact discs is in compliance with the American Standard Code 
25 for Information Interchange (ASCII). 

BACKGROUND 

[0005] Very early on, computer software came to be categorized as "operating system" software or "application" 
30 software. Broadly speaking, an application is software meant to perform a specific task for the computer user such as 
solving a mathematical equation or supporting word processing. The operating system is the software that manages 
and controls the computer hardware. The goal of the operating system is to make the computer resources available 
to the application programmer while atthe same time, hiding the complexity necessary to actually control the hardware. 
[0006] The operating system makes the resources available via functions that are collectively known as the Appli- 
es cation Program Interface or API. Theterm API is also used in reference to asingle one of these functions. Thefunctions 
are often grouped in terms of what resource or service they provide to the application programmer. Application software 
requests resources by calling individual API functions. API functions also serve as the means by which messages and 
information provided by the operating system are relayed back to the application software. 

[0007] In addition to changes in hardware, another factor driving the evolution of operating system software has 
40 been the desire to simplify and speed application software development. Application software development can be a 
daunting task, sometimes requiring years of developer time to create a sophisticated program with millions of lines of 
code. For a popular operating system such as various versions of the Microsoft Windows® operating system, applica- 
tion software developers write thousands of different applications each yearthat utilize the operating system. A coherent 
and usable operating system base is required to support so many diverse application developers. 
45 [0008] Often, development of application software can be made simpler by making the operating system more com- 
plex. That is, if a function may be useful to several different application programs, it may be better to write it once for 
inclusion in the operating system, than requiring dozens of software developers to write it dozens of times for inclusion 
in dozens of different applications. In this manner, if the operating system supports a wide range of common functionality 
required by a number of applications, significant savings in applications software development costs and time can be 
50 achieved. 

[0009] Regardless of where the line between operating system and application software is drawn, it is clear that for 
a useful operating system, the API between the operating system and the computer hardware and application software 
is as important as efficient internal operation of the operating system itself. 

[0010] Furthermore, most applications make use of data. This data can oftentimes change during execution of and/ 
55 or the life of the application, and is typically stored on a local device or on some remote device (e.g., a file server or 
other computing device on a network). Traditionally, applications have "owned" their own data, with each application 
being responsible for managing its own data (e.g., retrieving, saving, relocating, etc.) using its own formats. This tra- 
ditional structure has problems, however, as it makes searching for related data across applications very difficult, if not 



2 



EP 1 526 452 A2 

impossible, and frequently results in similar information having to be entered in multiple places (for example, contact 
information may have to be entered separately into an email application, a messenger application, a phone application, 
a word processor, and so forth). 

[0011] The inventors have developed a unique set of programming interface functions to assist in solving these 
5 problems. 

SUMMARY 

[0012] A programming interface for a computer platform is described herein. 
10 [0013] In accordance with certain aspects, the programming interface can include one or more of the following groups 
of types or functions: those related to core file system concepts, those related to entities that a human being can 
contact, those related to documents, those common to multiple kinds of media, those specific to audio media, those 
specific to video media, those specific to image media, those specific to electronic mail messages, and those related 
to identifying particular locations. 

15 

BRIEF DESCRIPTION OF THE DRAWINGS 

[0014] The same numbers are used throughout the drawings to reference like features. 

[0015] Fig. 1 illustrates a network architecture in which clients access Web services over the Internet using conven- 
20 tional protocols. 

[0016] Fig. 2 is a block diagram of a software architecture for a network platform, which includes an application 
program interface (API). 

[0017] Fig. 3 is a block diagram of unique namespaces supported by the API, as well as function classes of the 
various API functions. 

25 [0018] Fig. 4 is a block diagram of an example of the logical structure of namespaces. 

[0019] Fig. 5 is a block diagram of an exemplary computer that may execute all or part of the software architecture. 
[0020] Figs. 6,7,8,9, 10,11,12, 13,14,15, 16, and 1 7 illustrate various example implementations of a programming 
interface. 

30 DETAILED DESCRIPTION 

[0021] This disclosure addresses programming interfaces such as an application program interface (API) for a net- 
work platform upon which developers can build Web applications and services. More particularly, an exemplary API is 
described for operating systems that make use of a network platform, such as the .NET™ Framework created by 
35 Microsoft Corporation. The .NET™ Framework is a software platform for Web services and Web applications imple- 
mented in the distributed computing environment. It represents the next generation of Internet computing, using open 
communication standards to communicate among loosely coupled Web services that are collaborating to perform a 
particular task. 

[0022] In the described implementation, the network platform utilizes XML (extensible markup language), an open 
40 standard for describing data. XML is managed by the World Wide Web Consortium (W3C). XML is used for defining 
data elements on a Web page and business-to-business documents. XML uses a similar tag structure as HTML; how- 
ever, whereas HTML defines how elements are displayed, XML defines what those elements contain. HTML uses 
predefined tags, but XML allows tags to be defined by the developer of the page. Thus, virtually any data items can 
be identified, allowing Web pages to function like database records. Through the use of XML and other open protocols, 
45 such as Simple Object Access Protocol (SOAP), the network platform allows integration of a wide range of services 
that can be tailored to the needs of the user. Although the embodiments described herein are described in conjunction 
with XML and other open standards, such are not required for the operation of the claimed invention. Other equally 
viable technologies will suffice to implement the inventions described herein. 

[0023] As used herein, the phrase application program interface or API includes traditional interfaces that employ 
50 method or function calls, as well as remote calls (e.g., a proxy, stub relationship) and SOAP/XML invocations. 

EXEMPLARY NETWORK ENVIRONMENT 

[0024] Fig. 1 shows a network environment 100 in which a network platform, such as the .NET™ Framework, may 
55 be implemented. The network environment 100 includes representative Web services 102( 1 ), 102(N), which pro- 
vide services that can be accessed over a network 104 (e.g., Internet). The Web services, referenced generally as 
number 1 02, are programmable application components that are reusable and interact programmatically over the net- 
work 104, typically through industry standard Web protocols, such as XML, SOAP, WAP (wireless application protocol), 
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HTTP (hypertext transport protocol), and SMTP (simple mail transfer protocol) although other means of interacting 
with the Web services over the network may also be used, such as Remote Procedure Call (RPC) or object broker 
type technology. A Web service can be self-describing and is often defined in terms of formats and ordering of mes- 
sages. 

5 [0025] Web services 102 are accessible directly by other services (as represented by communication link 106) or a 
software application, such as Web application 110 (as represented by communication links 112 and 114). Each Web 
service 102 is illustrated as including one or more servers that execute software to handle requests for particular 
services. Such services often maintain databases that store information to be served back to requesters. Web services 
may be configured to perform any one of a variety of different services. Examples of Web services include login veri- 
fy fication, notification, database storage, stock quoting, location directories, mapping, music, electronic wallet, calendar/ 
scheduler, telephone listings, news and information, games, ticketing, and so on. The Web services can be combined 
with each other and with other applications to build intelligent interactive experiences. 

[0026] The network environment 100 also includes representative client devices 120(1), 120(2), 120(3), 120(4), 
1 20(M) that utilize the Web services 1 02 (as represented by communication link 1 22) and/or the Web application 1 1 0 

15 (as represented by communication links 124, 126, and 128). The clients may communicate with one another using 
standard protocols as well, as represented by an exemplary XML link 130 between clients 120(3) and 120(4). 
[0027] The client devices, referenced generally as number 1 20, can be implemented many different ways. Examples 
of possible client implementations include, without limitation, portable computers, stationary computers, tablet PCs, 
televisions/set -top boxes, wireless communication devices, personal digital assistants, gaming consoles, printers, pho- 

20 tocopiers, and other smart devices. 

[0028] The Web application 1 1 0 is an application designed to run on the network platform and may utilize the Web 
services 102 when handling and servicing requests from clients 120. The Web application 110 is composed of one or 
more software applications 130 that run atop a programming framework 132, which are executing on one or more 
servers 134 or other computer systems. Note that a portion of Web application 110 may actually reside on one or more 

25 of clients 1 20. Alternatively. Web application 1 1 0 may coordinate with other software on clients 1 20 to actually accom- 
plish its tasks. 

[0029] The programming framework 132 is the structure that supports the applications and services developed by 
application developers. It permits multi-language development and seamless integration by supporting multiple lan- 
guages. It supports open protocols, such as SOAP, and encapsulates the underlying operating system and object 
30 model services. The framework provides a robust and secure execution environment for the multiple programming 
languages and offers secure, integrated class libraries. 

[0030] The framework 132 is a multi-tiered architecture that includes an application program interface (API) layer 
142 : a common language runtime (CLR) layer 144, and an operating system/services layer 146. This layered archi- 
tecture allows updates and modifications to various layers without impacting other portions of the framework. A common 

35 language specification (CLS) 140 allows designers of various languages to write code that is able to access underlying 
library functionality. The specification 140 functions as a contract between language designers and library designers 
that can be used to promote language interoperability. By adhering to the CLS, libraries written in one language can 
be directly accessible to code modules written in other languages to achieve seamless integration between code mod- 
ules written in one language and code modules written in another language. One exemplary detailed implementation 

40 of a CLS is described in an ECMA standard created by participants in ECMA TC39/TG3. The reader is directed to the 
ECMA web site at www.ecma.ch. 

[0031] The API layer 142 presents groups of functions that the applications 130 can call to access the resources 
and services provided by layer 146. By exposing the API functions for a network platform, application developers can 
create Web applications for distributed computing systems that make full use of the network resources and other Web 
45 services, without needing to understand the complex interworkings of how those network resources actually operate 
or are made available. Moreover, the Web applications can be written in any number of programming languages, and 
translated into an intermediate language supported by the common language runtime 1 44 and included as part of the 
common language specification 140. In this way, the API layer 142 can provide methods for a wide and diverse variety 
of applications. 

so [0032] Additionally, theframework 132 can be configured to support API calls placed by remote applications executing 
remotely from the servers 134 that host the framework. Representative applications 148(1) and 148(2) residing on 
clients 120(3) and 1 20(M), respectively, can use the API functions by making calls directly, or indirectly, to the API layer 
1 42 over the network 1 04. 

[0033] The framework can also be implemented at the client devices 120. Client 120(3) represents the situation 
55 where a framework 1 50 is implemented at the client. This framework may be identical to server-based framework 1 32, 
or modified for client purposes. The framework 150 includes an API layer analogous to (or identical to) API layer 142 
of framework 132. Alternatively, the client-based framework may be condensed in the event that the client is a limited 
or dedicated function device, such as a cellular phone, personal digital assistant, handheld computer, or other com- 
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munication/computing device. 

DEVELOPERS' PROGRAMMING FRAMEWORK 

5 [0034] Fig. 2 shows the programming framework 1 32 in more detail. The common language specification (CLS) layer 
140 supports applications written in a variety of languages 130(1), 130(2), 130(3), 130(4), 130(K). Such application 
languages include Visual Basic, C++, C#, COBOL, Jscript, Perl, Eiffel, Python, and so on. The common language 
specification 1 40 specifies a subset of features or rules about features that, if followed, allow the various languages to 
communicate. For example, some languages do not support a given type (e.g., an "int*" type) that might otherwise be 

10 supported by the common language runtime 144. In this case, the common language specification 140 does not include 
the type. On the other hand, types that are supported by all or most languages (e.g., the "int[]" type) is included in 
common language specification 140 so library developers are free to use it and are assured that the languages can 
handle it. This ability to communicate results in seamless integration between code modules written in one language 
and code modules written in another language. Since different languages are particularly well suited to particular tasks, 

15 the seamless integration between languages allows a developer to select a particular language for a particular code 
module with the ability to use that code module with modules written in different languages. The common language 
runtime 144 allow seamless multi-language development, with cross language inheritance, and provide a robust and 
secure execution environmentforthe multiple programming languages. For more information on the common language 
specification 140 and the common language runtime 144, the reader is directed to co-pending applications entitled 

20 "Method and System for Compiling Multiple Languages", filed 6/21/2000 (serial number 09/598,1 05) and "Unified Data 
Type System and Method" filed 7/10/2000 (serial number 09/613,289), which are incorporated by reference. 
[0035] The framework 132 encapsulates the operating system 146(1) (e.g., Windows®-brand operating systems) 
and object model services 146(2) (e.g., Component Object Model (COM) or Distributed COM). The operating system 
146(1) provides conventional functions, such as file management, notification, event handling, user interfaces (e.g., 

25 windowing, menus, dialogs, etc.). security, authentication, verification, processes and threads, memory management, 
and so on. The object model services 146(2) provide interfacing with other objects to perform various tasks. Calls made 
to the API layer 1 42 are handed to the common language runtime layer 1 44 for local execution by the operating system 
146(1) and/or object model services 146(2). 

[0036] The API 142 groups API functions into multiple namespaces. Namespaces essentially define a collection of 

30 classes, interfaces, delegates, enumerations, and structures, which are collectively called "types", that provide a spe- 
cific set of related functionality. A class represents managed heap allocated data that has reference assignment se- 
mantics. A delegate is an object oriented function pointer. An enumeration is a special kind of value type that represents 
named constants. A structure represents static allocated data that has value assignment semantics. An interface de- 
fines a contract that other types can implement. 

35 [0037] By using namespaces, a designer can organize a set of types into a hierarchical namespace. The designer 
is able to create multiple groups from the set of types, with each group containing at least one type that exposes 
logically related functionality. In the exemplary implementation, the API 142 is organized to include three root name- 
spaces. It should be noted that although only three root namespaces are illustrated in Fig. 2, additional root namespaces 
may also be included in API 142. The three root namespaces illustrated in API 142 are: a first namespace 200 for a 

40 presentation subsystem (which includes a namespace 202 for a user interface shell), a second namespace 204 for 
web services, and a third namespace 206 for a file system. Each group can then be assigned a name. For instance, 
types in the presentation subsystem namespace 200 can be assigned the name "Windows", and types in the file system 
namespace 206 can be assigned names "Storage". The named groups can be organized under a single "global root" 
namespace for system level APIs, such as an overall System namespace. By selecting and prefixing a top level iden- 

45 tifier, the types in each group can be easily referenced by a hierarchical name that includes the selected top level 
identifier prefixed to the name of the group containing the type. For instance, types in the file system namespace 206 
can be referenced using the hierarchical name "System. Storage". In this way, the individual namespaces 200, 204, 
and 206 become major branches off of the System namespace and can carry a designation where the individual name- 
spaces are prefixed with a designator such as a "System." prefix. 

so [0038] The presentation subsystem namespace 200 pertains to programming and content development. It supplies 
types that allow for the generation of applications, documents, media presentations and other content. For example, 
presentation subsystem namespace 200 provides a programming model that allows developers to obtain services from 
the operating system 146(1) and/or object model services 146(2). 

[0039] The shell namespace 202 pertains to user interface functionality. It supplies types that allow developers to 
55 embed user interface functionality in their applications, and further allows developers to extend the user interface 
functionality. 

[0040] The web services namespace 204 pertains to an infrastructure for enabling creation of a wide variety of web 
applications, e.g. applications as simple as a chat application that operates between two peers on an intranet, and/or 
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as complex as a scalable Web service for millions of users. The described infrastructure is advantageously highly 
variable in that one need only use those parts that are appropriate to the complexity of a particular solution. The 
infrastructure provides a foundation for building message-based applications of various scale and complexity. The 
infrastructure or framework provides APIs for basic messaging, secure messaging, reliable messaging and transacted 
5 messaging. In the embodiment described below, the associated APIs have been factored into a hierarchy of name- 
spaces in a manner that has been carefully crafted to balance utility, usability, extensibility and versionability. 
[0041] The file system namespace 206 pertains to storage. It supplies types that allow for information storage and 
retrieval. 

[0042] In addition to the framework 132, programming tools 220 are provided to assist the developer in building Web 
10 services and/or applications. One example of the programming tools 220 is Visual Studio™, a multi-language suite of 
programming tools offered by Microsoft Corporation. 

ROOT API NAMESPACES 

15 [0043] Fig. 3 shows the file system namespace 206 in more detail. In one embodiment, the namespaces are identified 
according to a hierarchical naming convention in which strings of names are concatenated with periods. For instance, 
the file system namespace 206 is identified by the root name "System. Storage". Within the "System. Storage" name- 
space is another namespace for synchronization, identified as "System.Storage.Synchronization". With this naming 
convention in mind, the following provides a general overview of the file system namespace 206, although other naming 

20 conventions could be used with equal effect. 

[0044] The file system namespace 206 ("System. Storage"), includes classes and APIs that support the file system. 
The file system, which may also be referred to as "WinFS", is an active storage platform for organizing, searching for, 
and sharing all kinds of information. This platform defines a rich data model, builds on top of a relational storage engine, 
supports a flexible programming model, and provides a set of data services for monitoring, managing, and manipulating 

25 data. The data can be file-based or non-file data, and data is typically referred to as an "item". The file system extends 
the functionality typically provided by file systems because it also deals with items that are non-file data, such as 
personal contacts, event calendars, and e-mail messages. Additional information regarding the file system can be 
found in U.S. Patent Application No. 10/646,545, filed 8/21/03, entitled "Systems and Methods for Interfacing Applica- 
tion Programs with an Item-Based Storage Platform", which is hereby incorporated by reference. 

30 [0045] The file system namespace 206 defines additional namespaces, which may also be referred to as schemas. 
These additional namespaces include one or more of: Synchronization namespace 302, Notification (or Notifications) 
namespace 304, Meta namespace 306, Core namespace 308, Base namespace 310, Contact (or Contacts) name- 
space 312, Document (or Documents) namespace 31 4, Media namespace 316, Audio namespace 31 8, Video name- 
space 320, Image (or Images) namespace 322, Message (or Messages) namespace 324, Fax namespace 326, Email 

35 (or Mail) namespace 328, Annotation (or Annotations) namespace 330, Note (or Notes) namespace 332, Program (or 
Programs) namespace 334, Explorer namespace 336, NaturalUI (or NaturalUserlnterface) namespace 338, ShellTask 
(or ShellTasks) namespace 340, UserTask (or User Tasks) namespace 342, Help (or Assistance) namespace 344, 
Service (or Services) namespace 346, Location (or Locations) namespace 348, Principal (or Principals) namespace 
350, Calendar (or Calendars) namespace 352, Watcher namespace 354, Interop namespace 356, File (or Files) name- 

40 space 358, GameLibrary (or GameLibraries) namespace 360, and CategoryHierarchy (or CategoryHierarchies) 362. 
[0046] The file system namespace 206 defines a data model for the file system. The file system namespace 206 
describes the basic conceptual structure for defining other namespaces, which are described in more detail below. 
The file system namespace 206 includes, for example, definitions of items, relationships, nested elements, extensions, 
and so forth. 

45 [0047] The Synchronization namespace 302 ("System.Storage.Synchronization") defines classes and interfaces that 
allows data and data changes to be moved between the WinFS file system and other file systems. The functionality 
defined by namespace 302 allows, for example, data stored in formats defined by previous (legacy) file systems, 
databases, and other data storage structures to be represented and manipulated in the WinFS file system, thereby 
making the data accessible to the functionality of the other namespaces described herein. The functionality defined 

50 by namespace 302 further allows, for example, data stored in the WinFS file system to be represented and manipulated 
in other data storage structures or formats. 

[0048] The Notifications (or Notification) namespace 304 ("System. Storage. Notifications" or "System. Storage. Noti- 
fication") defines classes and interfaces that allow for the creation and management of rules. The Notifications name- 
space 304 allows rules to be defined (e.g., by applications) as well as actions to take when data events (such as the 
55 addition, modification, or deletion of data) conforming to one of the rules is detected. The file system monitors these 
rules for data events that conform to the rules and takes the defined actions when such data events are detected. The 
file system may search through data that is stored in the file system to detect data that such an event has occurred, 
and/or analyze data as it is accessed (e.g., by the same application defining the rule or a different application) to detect 
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whether operations on data conform to one or more of the rules. 

[0049] The M eta namespace 306 ("System. Storage. Meta") is used to define other schemas in file system namespace 
206 (also referred to as the other namespaces in file system namespace 206). The Meta namespace 306 defines the 
overall schema or namespace of these other namespaces in namespace 206 in a form that allows querying (e.g., to 

5 allow applications to see what types have been installed as part of the file system). New types can be created by 
authoring a schema document (e.g., in an XML (extensible Markup Language) format, other markup language format, 
or other non-markup language format) and installing that schema document as part of the file system. For example, 
in certain embodiments the meta namespace 306 defines a type which may be called "type" and a type which may be 
called "property", with a relationship between the "type" type and the "property" type that indicates which properties 

10 are found with which types. By way of another example, certain embodiments define a type which may be called 
"schema" in the meta namespace 306, with a relationship between the "type" type and the "schema" type that indicates 
which types appear in which schemas (namespaces). 

[0050] The Core namespace 308 ("System. Storage. Core") defines types that are regarded as being the core con- 
cepts behind the WinFS file system. The Core namespace 308 represents the core concepts that the operating system 

15 itself is expected to understand, and that are expected to be used by most other subnamespaces 302 - 362. For 
example, in certain embodiments the Core namespace 308 defines the following seven types: message (an item that 
represents any of a variety of different kinds of messages, such as Email messages, fax messages, and so forth), 
document (an item that represents content that is authored), contact (an item that represents an entity that can be 
contacted by a human being), event (an item that records the occurrence of something in the environment), task (an 

20 item that represents work that is done at a particular point in time or repeatedly over time, or as a result of some event 
other than the passage of time), device (a logical structure that supports information processing capabilities), and 
location (an item that represents one physical or geographic space). 

[0051] The Base namespace 310 ("System. Storage. Base") defines types that form the foundation of the WinFS file 
system. These are the types that are typically necessary in order for the file system to operate and support the other 
25 subnamespaces 302 - 362. These types may be defined in namespace 31 0 ("System. Storage. Base"), or alternatively 
in file system namespace 206 ("System. Storage"). 

[0052] As illustrated in Fig. 3, several additional namespaces 31 2 - 362 are also included in file system 206 in addition 
to the synchronization namespace 302, notifications namespace 304, meta namespace 306, core namespace 308, 
and base namespace 310. Each of the additional namespaces 312 - 362 defines a collection of related functionality. 
30 The determination of which namespace 312 - 362 particular functionality is to be part of is made by considering at least 
how tightly tied the particular functionality is to other functionality already defined in the namespaces 31 2 - 362. Func- 
tionality that is tightly tied together is typically included in the same namespace. 

[0053] An example of the logical structure of the namespaces 302 - 362 in file system namespace 206 can be seen 
in Fig. 4. Storage engine 370 provides the storage for the file system, and in certain embodiments storage engine 370 

35 is a relational database. Base namespace 310 is situated on top of storage engine 370 along with any other types 
defined in file system namespace 206 - this combination may also be referred to as the data model of the file system. 
Core namespace 308 is situated on top of base namespace 310, and one or more of the remaining namespaces 312 
- 362 of Fig. 3 are situated on top of core namespace 308 (these namespaces are identified as namespaces 372(1), 
372(2) 372(n) in Fig. 4). The Meta namespace 306 is situated to the side of namespaces 308, 310, and 372, as it 

40 is used to describe the types in those namespace 308, 310, and 372. One or more applications 374 sit on top of 
namespaces 372, and also on top of core namespace 308, base namespace 310, and meta namespace 306. Thus, 
applications 374 can access and define their own namespaces, building them on top of one or more of base namespace 
310. core namespace 308, and namespaces 372. 

[0054] Returning to Fig. 3 : a discussion of the functionality defined in the namespaces 31 2 - 362 follows. 
45 [0055] The Contacts (or Contact) namespace 31 2 ("System. Storage. Contacts" or "System. Storage. Contact") defines 
types representing entities that a human being can contact such as people, groups, organizations, households, and 
so forth. Theway in which such entities could becontacted can vary, such as by electronic mail address, phone number, 
chat address, postal address, and so forth. 

[0056] The Documents (or Document) namespace 314 ("System. Storage. Documents" or "System. Storage. Docu- 
50 ment") defines document types that can be accessed and used by the other namespaces 302 - 362. These document 
types refer to different document formats that can be accessed and used. Some document types may be included by 
default in namespace 31 4, and application designers can extend these namespace 31 4 to include different document 
types of their own design and/or choosing. 

[0057] The Media namespace 31 6 ("System. Storage. Media") defines base types used for audio, video, image, and 
55 other kinds of media. These base types are typically types that can be used by multiple kinds of media (e.g., both audio 
and video). These types can include, for example, types for meta data regarding the media (e.g.. a history of actions 
taken with the media (e.g., whether it was edited, who it wassentto, etc.), a rating forthe media, and so forth). Additional 
types specific to particular kinds of media are defined in the particular namespaces for those media (e.g., Audio name- 
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space 318 and Video namespace 320). 

[0058] The Audio namespace 318 ("System. Storage. Audio") defines types specific to audio media. These types can 
include, for example, types for meta data regarding audio media (e.g., artist name, album name, and so forth). 
[0059] The Video namespace 320 ("System. Storage. Video") defines types specific to video media. 
5 [0060] The Images (or Image) namespace 322 ("System. Storage. Images" or"System. Storage. Image") defines types 
specific to image media. The Images namespace 322 includes types used to represent different kinds of images, such 
as properties of file formats for presenting images (e.g., using the GIF, TIFF, JPEG, etc. formats), or properties that 
represent the semantic contents of a file (e.g., photographer, people in the image, etc.). 

[0061] The Message (or Messages) namespace 324 ("System. Storage. Message" or "System. Storage. Messages") 
10 defines types used for any kind of message, such as Email messages, Fax messages, IM (instant messaging) mes- 
sages, and so forth. These types are typically types that can be used by multiple kinds of media (e.g., both Email 
messages and IM messages). Additional types specific to particular kinds of messages are defined in the particular 
namespaces for those messages (e.g., Fax namespace 326 and Email (or Mail) namespace 328). 
[0062] The Fax namespace 326 ("System. Storage. Fax") defines types specific to facsimile messages. These types 
15 can include, for example, types for details regarding transmission of facsimile messages. 

[0063] The Email (or Mail) namespace 328 ("System. Storage. Email" or "System. Storage. Mail") defines types specific 
to electronic mail messages. 

[0064] The Annotation (or Annotations) namespace 330 ("System. Storage.Annotation" or "System. Storage. Annota- 
tions") defines types used to annotate documents. An annotation describes additional information linked to one or more 

20 pieces of data. Examples of annotations include: a text bubble next to a paragraph, a highlight of some text, a margin- 
bar next to paragraphs, an audio comment, an ink-annotation of some text, and so forth. The Annotation namespace 
330 allows different kinds of data to act as the annotation content, and provides a flexible mechanism to specify where 
the annotation is anchored. The annotation system can be, for example, the Common Annotation Framework (CAF) - 
additional details regarding the Common Annotation Framework (CAF) are available from Microsoft Corporation of 

25 Redmond. Washington. 

[0065] The Note (or Notes) namespace 332 ("System. Storage. Notes" or "System. Storage. Note") defines types for 
items which are notes. These notes can be, for example, Microsoft® Windows® operating system Journal notes, elec- 
tronic "sticky" notes, and so forth. 

[0066] The Programs (or Program) namespace 334 ("System. Storage. Programs" or "System. Storage. Program") de- 
30 fines types that allow a database of programs that are installed in the system to be maintained. This database can 
then be accessed by, for example, the operating system or other applications and information regarding programs that 
are installed in the system can be obtained. 

[0067] The Explorer namespace 336 ("System. Storage. Explorer") defines types that allow a history list for use with 
the operating system to be maintained and accessed. The history list is, for example, a record of actions taken by the 
35 user, such as a record of locations in the file system that have been accessed (e.g., a list of folders that have been 
opened as a user navigates through the file system looking for a file). 

[0068] The NaturalUI (or NaturalUserlnterface) namespace 338 ("System. Storage. NaturalUI" or "System. Storage. 
Natural Userlnterface") defines types used to support a natural language search engine. The types are used, for ex- 
ample, to store data regarding word equivalences, rules, and other aspects of natural language processing. 
40 [0069] TheShellTask(orShellTasks) namespace 340 ("System. Storage. ShellTask" or "System. Storage. ShellTasks") 
defines types used to provide lists of tasks in the user interface shell to let users know what actions they can perform 
as they navigate the user interface. The functionality of the ShellTask namespace 340 may alternatively be incorporated 
into the NaturalUI namespace 338. 

[0070] The UserTask (or UserTasks) namespace 342 ("System. Sto rage. UserTask" or " System. Sto rage. UserTasks") 
45 defines types used to allow user tasks to be created and managed, including being delegated to others, accepted or 
rejected, modified, and so forth. The user tasks are tasks analogous to those often provided with personal information 
manager (PIM) applications, such as jobs to be performed, phone calls to make, projects to complete, items to purchase, 
and so forth. The types further allow relationships to be defined, such as a relationship between a user task and an 
event (the event that is supposed to initiate the task), a relationship between a user task and a message (the message 
50 that notifies or reminds the user of the task), a relationship between a user task and a person (such as the person that 
assigned the task, the person to which the task is assigned, and so forth). 

[0071] The Help (or Assistance) namespace 344 ("System. Storage. Help" or "System. Storage. Assistance") defines 
types used to allow help information to be maintained and accessed. This help information can be displayed to the 
user (e.g., when requested by the user) to assist the user in performing various actions when using the system. 
55 [0072] The Services (or Service) namespace 346 ("System. Storage. Services" or "System. Storage. Service") defines 
types that allow service endpoints to be maintained and accessed. These service endpoints allow users to use services 
on the local computing device or over a network, such as the Internet. For example, a service endpoint could identify 
a service that is to be used to allow the user to instant message another user of a different system, or chat with that 
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other user. 



[0073] The Locations (or Location) namespace 348 ("System. Storage. Locations" or "System. Storage. Location") de- 
fines types used to identify particular physical or geographic locations. These locations can be, for example, postal 
addresses or coordinates (e.g., latitude and longitude type information, Global Positioning System (GPS) coordinates, 

5 and so forth). The locations can be, for example, locations of contacts described using contacts namespace 312. 

[0074] The Principals (or Principal) namespace 350 ("System. Storage. Principals" or"System. Storage. Principal") de- 
fines types used to maintain information regarding security principals. A security principal refers to anything in the 
system that can have access rights assigned to it (e.g., an item or a resource of the system). These types in the 
Principals namespace 350 allow security principals to be identified and allow the access rights for those security prin- 

10 cipals to be identified and assigned (e.g., identifying who or what has access to the security principal). 

[0075] The Calendar (or Calendars) namespace 352 ("System. Storage. Calendar" or "System. Storage. Calendars") 
defines types used to maintain and access information regarding appointments and attendees. Appointments may 
include, for example, information regarding time, location, recurrence, reminders, attendees, and so forth, as well as 
title and message body. Appointment attendees may include, for example, email address, availability, and response 

15 (e.g., whether the attendee accepted or declined the appointment). 

[0076] The Watcher namespace 354 ("System. Storage.Watcher") defines types used to allow the creation and man- 
agement of event monitoring and resultant actions. These types allow an interest in the occurrence of some type of 
event to be registered, as well as an indication of what should occur if and when that event does occur. When the 
specified event occurs, the specified action is taken by the system. 

20 [0077] The I nterop namespace 356 ("System. Storage. Interop") defines a set of namespaces parallel to namespaces 
306-354 and 358-362 containing classes used by non-managed consumers (consumers not writing to the Common 
Language Runtime). For example, a "System. Storage. Interop. Video" would contain the classes related to video media 
that could be called from unmanaged consumers. Alternatively, such classes could live in an "Interop" namespace 
nested below each of the namespaces 306-354 and 358-362. For example, classes related to video media that could 

25 be called from unmanaged consumers could be located in a "System. Storage. Video. Interop" namespace. 

[0078] The Files (or File) namespace 358 ("System. Storage. Files" or "System. Storage. File") defines types used to 
maintain information regarding files stored in the file system. These types can include, for example, meta data or 
properties regarding files stored in the file system. Alternatively, these types may be defined in the file system name- 
space 206 (that is, in the System. Storage namespace). 

30 [0079] The GameLibrary (or GameLibraries) namespace 360 ("System. Storage. GameLibrary" or "System. Storage. 
GameLibraries") defines types used to represent games that are installed in the system. These types can include, for 
example, meta data regarding games that are installed in the system, and types that allow querying so that applications 
can identify which games are installed in the system. 

[0080] The Category Hierarchy (Category Hierarchies) namespace 362 ('System. Storage. 
35 Category Hierarchy" or "System. Storage. CategoryHierarchies") defines types used to represent and navigate hierar- 
chical category dictionaries. 

EXAMPLE NAMESPACE MEMBERS 

40 [0081] This section includes multiple tables describing the examples of members that may be exposed by example 
namespaces (e.g., namespace in file system namespace 206 of Fig. 2). These exposed members can include, for 
example, classes, interfaces, enumerations, and delegates. It is to be appreciated thatthe members described in these 
examples are only examples, and that alternatively other members may be exposed by the namespaces. 
[0082] It should be appreciated that in some of namespace descriptions below, descriptions of certain classes, in- 

45 terfaces, enumerations and delegates are left blank. More complete descriptions of these classes, interfaces, enumer- 
ations and delegates can be found in the subject matter of the compact discs that store the SDK referenced above. 

System .Storage 

so [0083] The following tables list examples of members exposed by the System. Storage namespace. 



Classes 



[0084] 



55 



AlreadyAssociated With Item Exception 
A I ready Constructed Exception 



object has already been associated with an ItemContext 
Encapsulates an exception for an attempt to instantiate an 
already instantiated object. 



9 



A I ready Exists Exception 
AlreadySubscribed Exception 

5 

AsyncException 

AsyncResultException 

10 BackupOptions 

CannotDeleteNonEmptyFolderException 
CategoryRef 

15 

Categ o ry R ef Co 1 1 ecti o n 
CategoryRefEnumerator 
CateizoryRef Holder 
20 ChangeCollection 

ClassNotRegisteredException 
CommitQutQfQrderException 

ConnectionException 

25 

ConstraintAttribute 
Container 
Container Attribute 
CyclicOwningLinksException 
30 DateTimeRangeConstraintAttribute 

DecimalRangeConstraintAttribute 

DelayLoad 
35 DeleteErrorException 
Element 
Extension 



40 

ExtensionCollection 
ExtensionEnumerator 
ExtensionHolder 
45 FieldAttribute 

Filter 

FilterException 

50 FindOptions 
FindResult 

FindResultEnumerator 
FindResultException 

55 

FloatRangeConstraintAttribute 
Folder 



EP 1 526 452 A2 

Exception thrown when trying to create a object that logi- 
cally already exists 

Encapsulates an exception when a data class client at- 
tempted to subscribe to data change notification on a data 
class object it has already subscribed to. 
Encapsulates an exception for any asynchronous operation 
failure. 

Encapsulates an exception for errors encountered in the 
result set of an asynchronous query. 
Encapsulates the options available for backing up a item to 
a stream. 

Folder to be deleted must be empty 

A Category reference Identity key. Every category Node has 
an identity key of type CategoryRef. When category refenc- 
es are tagged onto an item, they are tagged as a link type 
where the Link.Target contains a CategoryRef. 
A CategoryRef collection 

A class for enumerating a CategoryRef collection 

a class to hold CategoryRef objects 

Encapsulates a colleciton of changes. 

A CLR class not registered for COM-lnterop 

outer transaction cannot be committed before ending the 

inner transaction 

Encapsulates an exception as a result of connection failure 
in WinFS API. 

Base class for constraint attributes. 

Encapsulates a container for holding other objects. 

a cycle in the object links was detected 
Specifies a date range constraint on the associated prop- 
erty. 

Specifies a decimal range constraint on the associated 
property. 

object deletion failed 

Base class for Nested Elements 

This is the type used as the basis for extensions. To estab- 
lish an extension a new subtype of this type is defined. The 
extension may be added to an Item by creating an instance 
of the type and assigning it to the Extensions field of the 
Item to be extended. 
A Extension collection 

A class for enumerating a Extension collection 
a class to hold Extension objects 

Defines the base class for a field attribute of an extended 
type. 

Encapsulate a parsed search filter expression. 
Encapsulates an exception for an invalid filter expression 
used in a query. 

Options used when executing a search. 
The FindResult class encapsulates a result set of query. 
Defines the basic behaviors of a FindResultEnumerator ob- 
ject. 

Encapsulates an exception for an error encountered in the 
result set of a query. 

Specifies a float range constraint on the associated prop- 
erty. 
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FolderMembersRelationship 

FolderMembersRelationshipCollection 

Identity Key 

IdentityKeyCollection 
5 IdentityKeyEn umerator 

Identity KeyH older 

InternalErrorException 

I nval idQ bject Except io n 

InvalidParameterException 
10 I nval idProperty Name Exception 

InvalidSortingExpression Exception 
InvalidSortingOrderException 
I nval idTypeCastExceptio n 

15 

Item 

ItemContext 



20 

ItemContextNotQpen Exception 
Item Id 

ItemldReference 
25 ItemName 

ItemNameCollection 

ItemNameEnumerator 

30 ItemNotFound Exception 
Item Path Reference 
ItemReference 
ItemSearcher 
Link 

35 LinkCollection 
LinkEnumerator 
LinkHolder 

LinkRelationshipAttribute 
Max Length Constraint Attribute 
40 " 

MemberNotFound Exception 
MultipleHoldingLinksException 

MultipleQbjects Found Exception 
^5 NestedAttribute 

NestedCollection 
NestedElement 
Nested ElementH older 
50 NestedElementlnMultipleHoldersExcepti on 
Nested Enumerator 



NoOwningElementException 

55 

NoQwningLinkException 
NoRelationshipException 



A IdentityKey collection 

A class for enumerating a IdentityKey collection 
a class to hold IdentityKey objects 
Encapsulates an exception for internal errors. 
Encapsulates an exception for an invliad object. 
InvalidParameterException. 

Encapsulates an exception for an invliad property of a 
WinFS type specified in a filter expression, 
the sorting expression is not valid 
the sorting order is invalid 

Encapsulates an exception for an invliad type cast specified 
in a filter expression. 

An instance of the ItemContext class defines an item do- 
main in which the owning "Longhorn" application operates 
to create, find, change, save and monitor items in the un- 
derlying "WinFS" store. 

exception raised when an ItemContext has not been 
opened yet 
Item Id. 

Itemld reference. 

ItemName represents the path name of an item 

An ItemNameCollection contains all the item names for an 

item 

An ItemNameEnumerator allows enumerating an Item- 
NameCollection 
item was not found 
Item path reference. 
Item reference. 
Item searcher. 

A Link collection 

A class for enumerating a Link collection 

a class to hold Link objects 

Represents a link relationship attribute. 

Specifies a maximum length constraint on the associated 

property 

a member was not found in the collection 

a newly created item can only have one holding link before 

it is saved to the store 

multiple objects were found while only one was expected 
Encapsulates an attribute of a type nested in an extended 
type. 

A collection for holding nested elements of an item. 



nested element can only be in one parent element or item 
Encapsulates an enumerator of a nested collection so that 
the collection can be enumerated using the foreach ... con- 
struct. 

a nested element does not have an owning element, nested 
elemented must be kept within an item 
An item does not have an owning link. In WinFS, evert item 
must have an owning (holding) link 

Encapsulates an exception when a relationship specified 
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NotAssociatedWithContextException 



5 NotConstructed Exception 
NotificationException 
NoTypeMappingException 

10 

NullableConstraintAttribute 

NullPropertyValueException 
15 QbjectCo I lection 



ObjectConversion Exception 
ObjectException 
20 QbjectHolder 



OutstandingTransaction Exception 
OwnerNotSaved Exception 
25 Parameter 

ParameterCo I lection 

Precision AndScaleConstraintAttribute 

ProjectionOption 
30 PropertyConstraintException 
Property Exception 
Query 

RecycleBinLink 
35 RecycleBinLinkCollection 

RecycleBinLinkEnumerator 

RecycleBinLinkHolder 

Relationship 

Relationshipld 
40 RestoreQptions 

RootltemBase 
ScalarAttribute 
SearcherException 
45 Search Expression 

Search ExpressionCollection 
Search Projection 
SetChangedEventArgs 

50 Share 

SortingException 

SortQption 
SortQptionCollection 
55 Span 

StorageException 
Store 

StoreQbject 



in a filter expression cannot be found. 
Encapsulates an exception when an operation of data class 
object not associated with an ItemContext instance is at- 
tempted in a WinFS store. 

Encapsulates an exception for an attempt to close an al- 
ready closed or never instanted object. 
Encapsulates an exception for a fail condition associated 
with data change notifications. 

Encapsulates an exception when a WinFS type specified 
in a query expression is not specified in the loaded type 
mappings. 

Specifies whether a property marked with this attribute is 
nullable or not. 

null value is not allowed for given property 

Used to delay load objects from the database. A field that 

is a collection and is delay loadable uses this class as a 

proxy. The real objects will be fetched on demand. 

cannot convert from one data type to another 

Encapsulates an exception for an invalid object. 

Used to delay load objects from the database. A field that 

is delay loadable uses this class as a proxy. The real object 

will be fetched on demand. 

the ItemContext still has outstanding transaction 

the owner of the object has not been saved yet. 

Represents a parameter name and value. 

A collection of parameter name/value pairs. 

This attribute specifies a precision and scale constraint on 

the associated property. 

Defines a field that is projected into the search result, 
property constaint violation 

Encapsulates an exception for an invalid property. 
Encapsulates a query consisting of the object type, filter 
string, sorting directives, and dependent object set. 

A RecycleBinLink collection 

A class for enumerating a RecycleBinLink collection 
a class to hold RecycleBinLink objects 
Base Relationship class. 
Relationship Id. 

Encapsulates the options for restoring an item from a 
stream. 

The base class of all the item data classes. 
Encapsulates a scalar attribute of an extended type. 
SearcherException . 
Expression used in a search. 
A collection of Search Expression. 
Contains the results of a search projection. 
Encapsulates the arguments passed to the SetChanged- 
Handler delegate. 

Encapsulates an exception for invalid sort primitive speci- 
fied in a query. 

Specifies sorting options used in a search. 

A collection of sort option objects. 

Encapsulates an object dependancy. 

The base class of all exceptions thrown by the WinFS API. 

Abstract base class used by "WinFS" data classes 
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S ubscri ption Fai I Exceptio n 
Transaction 

Transaction AlreadyCommittedQrRolledB ackException 
Transaction Exception 

TypeAttribute 

UnsubscriptionFailException 

UpdateException 

Util 

VirtualRelationshipCollection 
Volume 

VolumeCollection 



Encapsulates an exception for a failed attempt to subscribe 
to data change notification. 
Encapsulates a transaction. 

A transaction has already been committed or rolled back 
Encapsulates an exception for errors encountered in a 
transactional operation. 

Encapsulate of an attribute of an extended "WinFS" type. 
Encapsulates an exception for a failed attempt to unsub- 
scribe to data change notification. 

Encapsulates an exception for errors encountered in an Up- 
date operation. 

Various utilities used by the "WinFS" API 



A Volume collection 

A class for enumerating a Volume collection 
a class to hold Volume objects 



VolumeEnumerator 
VolumeHolder 



Interfaces 



[0085] 



I Category Ref Col lection 

ICategoryRef Enumerator 

IChangeManager 

ICollectionBase 

IDataClass 

lEIementBase 



lEnumeratorBase 

I ExtensionCol lection 

I Extension Enumerator 

lldentityKeyCollection 

I IdentityKey Enumerator 

I Item Base 

I Li nkCol lection 

ILinkEnumerator 

INestedBase 

IRecycleBinLinkCollection 
IRecycleBinLinkEnumerator 
IVolumeCollection 
I VolumeEnumerator 



An interface representing a Category Ref collection 

interface representing a class for enumerating a CategoryRef collection 

To be obsoleted. 

Defines the basic common behaviors of an implementing collection classes. 

This interface declares a set of standard methods that all data classes must implement. 

This interface defines some basic behaviors to be implemented by all element data 

classes. 

Defines the basic common behaviors of the implementing enumerator classes. 

An interface representing a Extension collection 

interface representing a class for enumerating a Extension collection 

An interface representing a IdentityKey collection 

interface representing a class for enumerating a IdentityKey collection 

This interface defines the common behavior of all the item-based data classes. 

An interface representing a Link collection 

interface representing a class for enumerating a Link collection 

This interface defines the common behaviors of nested element classes. 

An interface representing a RecycleBinLink collection 

interface representing a class for enumerating a RecycleBinLink collection 

An interface representing a Volume collection 

interface representing a class for enumerating a Volume collection 



Enumerations 



[0086] 

Called by system.storage.schemas.dll. 
Defines parts of a link relationship. 

Species if a range constraint is constrained by min value, max value, or both. 
This enumeration specifies the types of events in which a set changes. 
Specifies the sort order used in a SortOption object. 

Delegates 

[0087] 



EventType 
LinkRelationshipPart 
RangeConstraintType 
S etc hanged EventType 
SortOrder 



SetChangedHandler Event handler for set changed events. 
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System. Storage. Annotation 

[0088] The following tables list examples of members exposed by the System. Storage. Annotation namespace. 

Classes 

[0089] 



Annotation 



Typically an annotation is anchored in some context (e.g. the paragraph of some text) and 
contains some cargo (e.g. a text comment). Sometimes an annotation expresses the rela- 
tionship between multiple contexts (e.g. a comment that two paragraphs should be reor- 
dered). 



AnnotatorRelationship 
AnnotatorRelationshipCollection 



Content 



ContentCollection 
ContentE numerator 
ContentHolder 
Locator 



LocatorCollection 
LocatorEnumerator 
LocatorH older 
LocatorPart 



LocatorPartCollection 
LocatorPart Enumerator 
LocatorPart Holder 
RangePart 

RangePartCollection 
RangePartEnumerator 
RangePartHolder 
Resource 



ResourceCQllection 

ResourceEnumerator 

ResourceHolder 



The Content type represents literal information, e.g. TextContent, XMLContent, Highlight, 
InkContent, etc... The content data must adhere to the XSD type in the given namespace 
URI. 

A Content collection 

A class for enumerating a Content collection 
a class to hold Content objects 

A Locator describes the location or the identification of a particular datum. A Locator con- 
tains an ordered collection of LocatorParts. Applying each LocatorPart successively against 
an initial context will resolve into the particular datum. For example: a Locator could have 
two LocatorParts, the first specifying a "Win FS" item that is an image, and the second spec- 
ifying a graphical region. If a Locator has a Range, its Locators are applied after all original 
LocatorParts have been resolved. 
A Locator collection 

A class for enumerating a Locator collection 
a class to hold Locator objects 

Each LocatorPart describes location or identification of some information in some implied 
context. Examples for LocatorPart are: a reference to a "WinFS" item, the URI of some 
document, a marker ID, a text offset. The data for a LocatorPart must conform to the Xsi 
Type defined in the specified namespace. 
A LocatorPart collection 

A class for enumerating a LocatorPart collection 
a class to hold LocatorPart objects 

The type RangePart describes the location or the identificatio of a range of some informa- 
tion. It is composed of two Locators. 
A RangePart collection 

A class for enumerating a RangePart collection 
a class to hold RangePart objects 

A Resource groups identification, location, and content of some information. It is used for 
expressing contexts as well as cargo. This enables a context to cache the underlying data 
the annotation is anchored to (in addition to storing a reference to the underlying data), and 
it allows the cargo to be literal content, or a reference to already existing data, or both. 
A Resource collection 

A class for enumerating a Resource collection 
a class to hold Resource objects 



Interfaces 



[0090] 



IContentCollection 

IContentEnumerator 

ILocatorCollection 

ILocatorEnumerator 

ILocatorPartCollection 



An interface representing a Content collection 

interface representing a class for enumerating a Content collection 

An interface representing a Locator collection 

interface representing a class for enumerating a Locator collection 

An interface representing a LocatorPart collection 
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ILocatorPartEnumerator interface representing a class for enumerating a LocatorPart collection 

IRangePartCollection An interface representing a RangePart collection 

I Ran gePartE numerator interface representing a class for enumerating a RangePart collection 

IResourceCollection An interface representing a Resource collection 

I ResourceE numerator interface representing a class for enumerating a Resource collection 



System.Storage.Annotation.lnterop 

[0091] The following table lists examples of members exposed by the System. Storage. Annotation. I nterop name- 
space. 



Interfaces 



[0092] 

lAnnotation 

IContent 
I Locator 



ILocatorPart 

IRangePart 
I Resource 



Typically an annotation is anchored in some context (e.g. the paragraph of some text) and contains 
some cargo (e.g. a text comment). Sometimes an annotation expresses the relationship between mul- 
tiple contexts (e.g. a comment that two paragraphs should be reordered). 

The Content type represents literal information, e.g. TextContent, XMLContent, Highlight, InkContent, 
etc... The content data must adhere to the XSD type in the given namespace URI. 
A Locator describes the location or the identification of a particular datum. A Locator contains an or- 
dered collection of LocatorParts. Applying each LocatorPart successively against an initial context will 
resolve into the particular datum. For example: a Locator could have two LocatorParts, the first spec- 
ifying a "WinFS" item that is an image, and the second specifying a graphical region. If a Locator has 
a Range, its Locators are applied after all original LocatorParts have been resolved. 
Each LocatorPart describes location or identification of some information in some implied context. 
Examples for LocatorPart are: a reference to a "WinFS" item, the URI of some document, a marker 
ID, a text offset. The data for a LocatorPart must conform to the Xsi Type defined in the specified 
namespace. 

The type RangePart describes the location or the identificatio of a range of some information. It is 
composed of two Locators. 

A Resource groups identification, location, and content of some information. It is used for expressing 
contexts as well as cargo. This enables a context to cache the underlying data the annotation is an- 
chored to (in addition to storing a reference to the underlying data), and it allows the cargo to be literal 
content, or a reference to already existing data, or both. 



System-Storage. Audio 

[0093] The following tables list examples of members exposed by the System. Storage. Audio namespace. 
Classes 



[0094] 



Album 

AlbumLink 

AlbumLinkCollection 

AlbumLinkEnumerator 

AlbumLinkHolder AutoDJ 

AutoDJCollection 

AutoDJ Enumerator 

AutoDJHolder 

BaseTrack 

Location Reference 



Location ReferenceCollection 
Location ReferenceEnumerator 
Location ReferenceHolder 



The type Audio.Album represents an audio album which may contain several tracks. 
This type represents a link from Track to Album that this track belongs to. 
A AlbumLink collection 

A class for enumerating a AlbumLink collection 
a class to hold AlbumLink objects 
A AutoDJ collection 

A class for enumerating a AutoDJ collection 
a class to hold AutoDJ objects 

The type Audio. BaseTrack represents metadata for an audio track. 

Location Reference type represents a link to a Location item. It may be dangling, in 

which case the fields on this type specify the location coordinates. 

A Location Reference collection 

A class for enumerating a Location Reference collection 
a class to hold LocationReference objects 
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Metadata!, ink 
MetadataLinkCollection 
M etadataL in kE numerator 
Metadata!, in kH older 
PhysicalTrack 



PlatterTrack 



PlayList 

RadioStation 

RadioStream 



Track 



TrackMetadata 



This type represents a link from PhysicalTrack to TrackMetadata. 
A MetadataLink collection 

A class for enumerating a MetadataLink collection 
a class to hold MetadataLink objects 

The type Audio. PlatterTrack represents an audio track for which the actual audio 
data is not stored in "WinFS". The Audio bits themselves are still on a CD or another 
external storage. 

The type Audio. PlatterTrack represents an audio track for which the actual audio 
data is not stored in "WinFS". The Audio bits themselves are still on a CD or another 
external storage. 

The type Audio. PlayList represents an audio playlist. 

RadioStation type represents a radio station that may provide streams of radio. 
RadioStream type represents a radio stream that a radio station provides, it is in- 
tended to be an embedded item in the RadioStation item. 

The type Audio.Track represents an audio track that has the actual music data in it. 
It may correspond to a trackthat has been ripped from a CD, or otherwise completely 
stored in "WinFS". 

The type Audio.TrackMetadata contains computed or downloaded metadata for 
physical tracks. 



Interfaces 



[0095] 

lAlbumLinkCollection 

lAlbumLinkEnumerator 

lAutoDJCollection 

lAutoDJ Enumerator 

I Locat io n Ref e renceCo 1 1 ecti o n 

ILocationReferenceEnumerator 

I MetadataLinkCollection 

I MetadataLinkE numerator 



An interface representing a AlbumLink collection 

interface representing a class for enumerating a AlbumLink collection 

An interface representing a AutoDJ collection 

interface representing a class for enumerating a AutoDJ collection 

An interface representing a Location Reference collection 

interface representing a class for enumerating a Location Reference collection 

An interface representing a MetadataLink collection 

interface representing a class for enumerating a MetadataLink collection 



System.Storaqe.Audio.lnterop 

[0096] The following table lists examples of members exposed by the System. Storage. Audio. Interop namespace. 
Interfaces 



[0097] 

lAlbum 
lAlbumLink 
lAutoDJ 
IBaseTrack 
ILocation Reference 



I MetadataLink 
I PhysicalTrack 

I PlatterTrack 

I PlayList 

I RadioStation 

I RadioStream 

ITrack 



The type Audio. Album represents an audio album which may contain several tracks. 
This type represents a link from Track to Album that this track belongs to. 

The type Audio. BaseTrack represents metadata for an audio track. 

LocationReference type represents a link to a Location item. It may be dangling, in which case 

the fields on this type specify the location coordinates. 

This type represents a link from PhysicalTrack to TrackMetadata. 

The type Audio. PlatterTrack represents an audio track for which the actual audio data is not 
stored in "WinFS". The Audio bits themselves are still on a CD or another external storage. 
The type Audio. PlatterTrack represents an audio track for which the actual audio data is not 
stored in "WinFS". The Audio bits themselves are still on a CD or another external storage. 
The type Audio. PlayList represents an audio playlist. 

RadioStation type represents a radio station that may provide streams of radio. 
RadioStream type represents a radio stream that a radio station provides, it is intended to be 
an embedded item in the RadioStation item. 

The type Audio.Track represents an audio track that has the actual music data in it. It may 
correspond to a track that has been ripped from a CD, or otherwise completely stored in 
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ITrackMetadata 



"WinFS". 

The type Audio. TrackMetadata contains computed or downloaded metadata for physical tracks. 



Svstem.Storaae.Contact 

[0098] The following tables list examples of members exposed by the System. Storage. Contact namespace. 
Classes 



[0099] 

Accreditation 

AccreditationCollection 

Accreditation Enumerator 

Accreditation Holder 

ChildData 

ChildDataCollection 

ChildDataEnumerator 

ChildDataHolder 

EmployeeData 



EmployeePataCol lection 

EmployeePataEnumerator 

EmployeePataHolder 

EmployeeOf Relationship 

EmployeeOfRelationshipCollection 

FullName 



FullNameCollection 
FullName Enumerator 
FullNameHolder 
GeneralCategories 
Group 



Group Members hip 



GroupMembershipCollection 



A wrapper around scalar string to support multi-valued strings. 
A Accreditation collection 

A class for enumerating a Accreditation collection 
a class to hold Accreditation objects 
Pointer to any Contacts that are children of a Person 
A ChildPata collection 

A class for enumerating a ChildPata collection 
a class to hold ChildPata objects 

The organization link native to employeedata is the link to the organization 
that employs the Person, or the employer. This might not be the same or- 
ganization as the one for which the Person directly works. Example: The 
employee gets a paycheck from Bank of America. The employee actually 
works at the Seattle Branch #657. Both are listed as organizations as there 
can be multiple employees, but they are independent concepts. 
A EmployeePata collection 

A class for enumerating a EmployeePata collection 
a class to hold EmployeePata objects 



The fullname set associated with Person. PersonalNames. There can be one 
or many of these, but it is assumed that if the contact exists, it has at least 
one name. Names are classified by the user with the Item. Categories field, 
which is not shown in this definition, but which is part of the combined view 
for Person. Classifications for names may include Gamer names, profession- 
al and personal names. Names may represent "contextual views" on the Per- 
son. One of the classifications might be a special-cased (e.g. IsPefault) in- 
dicating that this is the default name. There may be one and only one FUII- 
Name marked in this way. The Person. PisplayName value is computed using 
the FullName. DisplayName value of the Pefault Fullname. The default cat- 
egory should be manipulated by the application and not the user (e.g. check 
box) so that default should not appear in the classification section of any Ul. 
The first fullname entered should be set to default, otherwise there will be no 
Person. PisplayName value 
A FullName collection 

A class for enumerating a FullName collection 
a class to hold FullName objects 

partial Contact. GeneralCategories class used to list standard category keys 
Pescribes the features of a basic group. This type can be extended by spe- 
cific group providers to incorporate information required for their group type. 
The friendly name of the group is taken from the group. PisplayName which 
is inherited. 

GroupMembership contains the references to members of a particular group. 
This is a link type between Person and Group. Group is the owning side of 
the link. Being derived from NestedElement, there is an inherited categories 
field that contains any number of classifications associated with this group 
member. 

A GroupMembership collection 
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GroupMembershipEnumerator 
Group Members hip Holder 
Household 



HouseholdMemberData 

HouseholdMemberDataCollection 

HouseholdMemberPataEnumerator 

HouseholdMemberDataHolder 

InstantMessagingAddress 



InstantMessagingAddressCollection 
InstantMessagingAddress Enumerator 
InstantMessagingAddressHolder 
LocalMachineDataFolder 



MemberOfGroupsRelationship 
MemberQfGroupsRelationshipCollection 
Organization 



Person 



A class for enumerating a GroupMembership collection 
a class to hold GroupMembership objects 

A household is a set of individuals who all live in the same house. Note that 
household does not imply family, for example, a group of roommates form a 
household but not a family. 

The actual references to household membership 
A HouseholdMemberData collection 

A class for enumerating a HouseholdMemberData collection 
a class to hold HouseholdMemberData objects 

The Presences representation of any EAddress.AccessPoint where the Ead- 
dress. ServiceType = "IM". This allows the application to quickly find all of the 
presence status' for a given IM address 
A InstantMessagingAddress collection 

A class for enumerating a InstantMessagingAddress collection 
a class to hold InstantMessagingAddress objects 

Used to hold machine profile information. This can be transferred with con- 
tacts when contacts are backed up or turned into a portable profile. It indi- 
cates where the contacts came from when it is not the local machine. It also 
contains machine wide information, such as EVERYONE, ADMINISTRA- 
TOR, etc. security groups. 



PresenceService 
Security ID 
Security IDCollection 
Security ID Enumerator 
SecuritylDHolder 
SmtpEmail Address 



SmtpEmailAddressCollection 
SmtpEmail AddressEnumerator 
SmtpEmail AddressHolder 
SpouseData 
SpouseDataCollection 
SpousePataEnumerator 
SpousePataHolder 
TelephoneNumber 



The organization information that may be associated with employeedata as 
the employer, the department within the employer's organization or be a 
stand alone entity. The friendly or display name for the organization is inher- 
ited. 

Information specific to a Person, where a Person references one and only 
one real world person Notethatthere is an explicit Expiration Pate ratherthan 
using the Item.EndPate. It is unclear whether or not the Person should be 
removed from the system based upon the Item.EndPate, but the notion here 
is that the EndPate may simply be used to indicate that the Person is no 
longer an active contact ratherthan one that should be removed upon reach- 
ing a certain date. The expirationdate is explicitly to be used to remove un- 
wanted contacts. 

Service that is able to provide presence information. 
The user's Local SIP 
A SecurityIP collection 

A class for enumerating a SecurityIP collection 
a class to hold SecurityIP objects 

SMTPEmail is derived from eaddress and schematizes only one of several 
different types of possible email. The purpose in schematizing SMTP email 
is to allow users to search/query on the domain value, just as they can query 
on postal code or area code. SMTP is probably the most common of the 
email address types available on the internet. Schematization requires pars- 
ing the Eaddress. AccessPoint string into the appropriate components. For 
example, if EAddress.AccessPoint = "blacknight@earthlink.net" then SMT- 
PEmailAddress.username="blacknight" and SMTPEmailAddress.do- 
main="earthlink.net" 
A SmtpEmailAddress collection 

A class for enumerating a SmtpEmailAddress collection 
a class to hold SmtpEmailAddress objects 
Pointer to a Contact that is a spouse of a Person 
A SpousePata collection 

A class for enumerating a SpousePata collection 
a class to hold SpousePata objects 

The schematized AccessPoint instance value using the AccessPoint tem- 
plate when the EAddress.ServiceType is one of the category type telephone. 
The purpose is to allow the user to quickly query for all numbers within a 
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TelephoneNumberCollection 
TelephoneNumberEnumerator 
TelephoneNumberHolder 
5 Template 



10 



15 



UserDataFolder 

20 



Web log Address 
WeblogAddressCol lection 
25 WeblogAddressEnumerator 
WeblogAddressHolder 
WellKnownFolder 



30 



WindowsPresence 

35 WindowsPresenceCollection 
WindowsPresenceEnumerator 
WindowsPresenceHolder 

Interfaces 

40 

[0100] 

lAccreditationCollection 

I Accreditation Enumerator 
45 IChildDataCollection 

IChildDataEnumerator 

I EmployeeDataCollection 

lEmployeePataEnumerator 

IFullNameCollection 
50 IFullNameEnumerator 

IGroupMembershipCol lection 

IGroupMembership Enumerator 

IHouseholdMemberPataCollection 
55 IHouseholdMemberPataEnumerator 

UnstantMessagingAddressCollection 
UnstantMessagingAddressEnumerator 



country code or an area code. 
A TelephoneNumber collection 

A class for enumerating a TelephoneNumber collection 
a class to hold TelephoneNumber objects 

A Template is a pre-set format for a particular Type that may be surface in 
the Ul as a input mask or used by an application or API as a validation re- 
quirement. Templates allow for the fact that many element types have one 
or more known and expected formats. Pata entered that does not meet one 
of these templates can cause applications and/or processes to break. Any 
type, however, might support multiple templates. For instance, a phone 
number might legitimately take the form of either 1-800- FLOWERS or 
1 -800-356-9377. Both are representative of a phone number. Understanding 
the template associated with the specific instance is also a boon when trans- 
lating the value in the Ul. For example, an application being executed on a 
"Longhorn" device in a country where letters are not typically available on 
phones might need to translate the phone number stored using the Template 
N-NNN-AAAAAAA before rendering. The template may be exposed to the 
user for selection or may be selected by the application itself. 
Specialized folder representing information that belongs only to this user, e. 
g., ..\dejans\documents. There is one per user on a machine. The Personal- 
Contacts virtual folder is rooted to this folder, as are temporary and MFU 
folders. 

WeblogAddress is a user's weblog, or "homepage", address. 
A WeblogAddress collection 

A class for enumerating a WeblogAddress collection 
a class to hold WeblogAddress objects 

Meant to be the base class for any specialized sub folder that contains well 

understood information, i.e., any folder that is known in the system - such as 

userdatafolder, temporary folders, MRU folders, etc. This would include such 

virtual folders as "temporary", "MFU/MRU", etc. The folder types indicate how 

the folder is used and acted upon. For instance, Temporary and MFU folder 

contents are not exposed as Contacts in MyContacts. 

General IM presence shown in the Shell. Presence provider can be MSN, 

Exchange, Yahoo, etc. 

A WindowsPresence collection 

A class for enumerating a WindowsPresence collection 
a class to hold WindowsPresence objects 



An interface representing a Accreditation collection 
interface representing a class for enumerating a Accreditation collection 
An interface representing a ChildPata collection 
interface representing a class for enumerating a ChildPata collection 
An interface representing a EmployeePata collection 
interface representing a class for enumerating a EmployeePata collection 
An interface representing a FullName collection 
interface representing a class for enumerating a FullName collection 
An interface representing a GroupMembership collection 
interface representing a class for enumerating a GroupMembership collec- 
tion 

An interface representing a HouseholdMemberPata collection 

interface representing a class for enumerating a HouseholdMemberPata 

collection 

An interface representing a InstantMessagingAddress collection 
interface representing a class for enumerating a InstantMessagingAddress 
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ISecuritylDCollection 
ISecuritylD Enumerator 
ISmtpEmailAddressCollection 
I S mtp E mai I Ad d ress E n u me rato r 

ISpouseDataCollection 
ISpouseDataEnumerator 
ITelephoneNumberCol lection 
ITelephoneNumberEnumerator 

IWeblogAddressCollection 
IWeblogAddressEnumerator 
I WindowsPresenceCol lection 
IWindowsPresenceEnumerator 



collection 

An interface representing a SecuritylD collection 
interface representing a class for enumerating a SecuritylD collection 
An interface representing a SmtpE mai lAd dress collection 
interface representing a class for enumerating a SmtpEmailAddress collec- 
tion 

An interface representing a SpouseData collection 
interface representing a class for enumerating a SpouseData collection 
An interface representing a TelephoneNumber collection 
interface representing a class for enumerating a TelephoneNumber collec- 
tion 

An interface representing a We blogAd dress collection 
interface representing a class for enumerating a WeblogAddress collection 
An interface representing a WindowsPresence collection 
interface representing a class for enumerating a WindowsPresence collec- 
tion 



Enumerations 



[0101] 

WindowsPresenceStatus 



System-Storage. Contact.lnterop 

[0102] The following table lists examples of members exposed by the System. Storage. Contact.lnterop namespace. 



Interfaces 



[0103] 

lAccreditation A wrapper around scalar string to support multi-valued strings. 

IChildData Pointer to any contacts that are children of a Person 

lEmployeeData The organization link native to employeedata is the link to the organization that employs 

the Person, or the employer. This might not be the same organization as the one for 
which the Person directly works. Example: The employee gets a paycheck from Bank 
of America. The employee actually works at the Seattle Branch #657. Both are listed as 
organizations as there can be multiple employees, but they are independent concepts. 

IFullName The fullname set associated with Person. PersonalNames. There can be one or many 

of these, but it is assumed that if the contact exists, it has at least one name. Names 
are classified by the user with the Item. Categories field, which is not shown in this def- 
inition, but which is part of the combined view for Person. Classifications for names may 
include Gamer names, professional and personal names. Names may represent "con- 
textual views" on the Person. One of the classifications might be a special-cased (e.g. 
IsPefault) indicating that this is the default name. There may be one and only one FUII- 
Name marked in this way. The Person. PisplayName value is computed using the Full- 
Name. PisplayName value of the Pefault Fullname. The default category should be ma- 
nipulated by the application and not the user (e.g. check box) so that default should not 
appear in the classification section of any Ul. The first fullname entered should be set 
to default, otherwise there will be no Person. PisplayName value 

IGroup Describes the features of a basic group. This type can be extended by specific group 

providers to incorporate information required for their group type. The friendly name of 
the group is taken from the group. DisplayName which is inherited. 

IGroupMembership GroupMembership contains the references to members of a particular group. This is a 

linktype between Person and Group. Group is the owning side of the link. Being derived 
from NestedElement, there is an inherited categories field that contains any number of 
classifications associated with this group member. 

IHousehold A household is a set of individuals who all live in the same house. Note that household 
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IHouseholdMemberData 
1 1 nstantM ess aging Address 



ILocalMachineDataFolder 



IQrganization 



I Person 



IPresenceService 
ISecuritylD 
ISecuritylDCustom 
ISmtpEmailAddress 



ISmtpEmailAddressCustom 
ISpouseData 
ITelephoneN umber 



ITemplate 



lUserDataFolder 



IWeblogAddress 
IWellKnown Folder 



does not imply family, for example, a group of roommates form a household but not a 
family. 

The actual references to household membership 

The Presences representation of any E Address. Access Point where the Eaddress. Serv- 
iceType = "IM". This allows the application to quickly find all of the presence status 1 for 
a given IM address 

Used to hold machine profile information. This can be transferred with contacts when 
contacts are backed up or turned into a portable profile. It indicates where the contacts 
came from when it is not the local machine. It also contains machine wide information, 
such as EVERYONE, ADMINISTRATOR, etc. security groups. 

The organization information that may be associated with employeedata as the employ- 
er, the department within the employer's organization or be a stand alone entity. The 
friendly or display name for the organization is inherited. 

Information specific to a Person, where a Person references one and only one real world 
person Note that there is an explicit ExpirationDate ratherthan using the Item.EndDate. 
It is unclear whether or not the Person should be removed from the system based upon 
the Item.EndDate, butthe notion here is that the EndDate may simply be used to indicate 
that the Person is no longer an active contact rather than one that should be removed 
upon reaching a certain date. The expiration date is explicitly to be used to remove un- 
wanted contacts. 

Service that is able to provide presence information. 
The user's Local SID 

SMTPEmail is derived from eaddress and schematizes only one of several different 
types of possible email. The purpose in schematizing SMTP email is to allow users to 
search/query on the domain value, just as they can query on postal code or area code. 
SMTP is probably the most common of the email address types available on the internet. 
Schematization requires parsing the Eaddress. AccessPoint string into the appropriate 
components. For example, if E Ad dress. Access Point = "blacknight@earthlink.net" then 
SMTPEmail Address. username="blacknight" and SMTPEmail Address. domain="earth- 
link.net" 

Pointer to a Contact that is a spouse of a Person 

The schematized AccessPoint instance value using the AccessPoint template when the 
EAddress.ServiceType is one of the category type telephone. The purpose is to allow 
the user to quickly query for all numbers within a country code or an area code. 
A Template is a pre-set format for a particular Type that may be surface in the Ul as a 
input mask or used by an application or API as a validation requirement. Templates allow 
for the fact that many element types have one or more known and expected formats. 
Data entered that does not meet one of these templates can cause applications and/or 
processes to break. Any type, however, might support multiple templates. For instance, 
a phone number might legitimately take the form of either 1-800- FLOWERS or 
1-800-356-9377. Both are representative of a phone number. Understanding the tem- 
plate associated with the specific instance is also a boon when translating the value in 
the Ul. For example, an application being executed on a "Longhorn" device in a country 
where letters are not typically available on phones might need to translate the phone 
number stored using the Template N-NNN-AAAAAAA before rendering. The template 
may be exposed to the user for selection or may be selected by the application itself. 
Specialized folder representing information that belongs only to this user, e.g., .Ade- 
jans\documents. There is one per user on a machine. The Personal Contacts virtual fold- 
er is rooted to this folder, as are temporary and MFU folders. 
WeblogAddress is a user's weblog, or "homepage", address. 

Meant to be the base class for any specialized sub folder that contains well understood 
information, i.e., any folder that is known in the system - such as userdatafolder. tem- 
porary folders, M RU folders, etc. This would include such virtual folders as "temporary", 
"MFU/MRU", etc. The folder types indicate how the folder is used and acted upon. For 
instance, Temporary and MFU folder contents are not exposed as Contacts in MyCon- 
tacts. 
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IWindowsPresence General IM presence shown in the Shell. Presence provider can be MSN, Exchange, 

Yahoo, etc. 

Svstem.Storaae.Core 

5 

[0104] The following tables list examples of members exposed by the System. Storage. Core namespace. 
Classes 
10 [0105] 
Address 

AddressCollection 
15 AddressEnumerator 

AddressH older 

ADSynchronization 

ADSynchronizationCollection 

ADSynchronization Enumerator 
20 ADSynchronizationHolder 

Author 

AuthorCollection 
AuthorEnumerator 
25 AuthorHolder 

AuthorRelationship 
AuthorRelationshipCollection 
BasicPresence 

30 



BasicPresenceCollection 

BasicPresenceEnumerator 
35 BasicPresenceHolder 

CalendarEvent 

CalendarEventCollection 

CalendarEventEnumerator 

CalendarEventHolder 
40 CategorizedNested Element 

Category 

Category Keyword 
Category Keyword Co I lection 
45 Category Keyword Enumerator 
Category Keyword Holder 
Commodity 

CommodityOwnerRelationship 
50 CommodityOwnerRelationshipC 
ollection 

ComponentRelationship 
ComponentRelationshipCollecti 
on 

55 Computer 
Contact 

Date This type represents a Date that can be used on a document. 

DateCollection A Date collection 



Address represents an address for contacting or a Contact via postal mail, or an 
indoor/outdoor location in the Location object. 
A Address collection 

A class for enumerating a Address collection 
a class to hold Address objects 
Synchronization parameters. 
A ADSynchronization collection 

A class for enumerating a ADSynchronization collection 
a class to hold ADSynchronization objects 

A link to person or company who is an author (or a co-author in case of multiple 
authors) 

A Author collection 

A class for enumerating a Author collection 
a class to hold Author objects 



It is expected that BasicPresence will be extended. For example, supporting IRC 
(Internet Relay Chat) presence. An example of an IRCPresence is. - DonH = Iden- 
tityKey - editing some.xls = IRCPresence (what is involved is given by IRCPres- 
ence) - on some machine = eAddress (where Don is presently editing the XLS is 
given by eAddress) 
A BasicPresence collection 

A class for enumerating a BasicPresence collection 
a class to hold BasicPresence objects 

A CalendarEvent collection 

A class for enumerating a CalendarEvent collection 
a class to hold CalendarEvent objects 
A nested Element with categories field. 

This represents the valid categories known to the current system. Categories (also 
known as taxonomies) include such things as the type values for eAddresses. 
Keyword used for categorizing/grouping an item. 
A Category Keyword collection 

A class for enumerating a CategoryKeyword collection 
a class to hold CategoryKeyword objects 

An identifiable thing that has value - this includes inanimate objects such as cars, 
houses, or furniture and animate objects such as pets or livestock. 
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Date Enumerator 

DateHolder 

Device 



Document 



EAddress 



EAddressCollection 
EAddressEnumerator 
EAddressHolder 
Event 



EventBody Relationship 

EventBodyRelationshipCollection 

EventExtension 

EventExtensionCollection 

EventExtension Enumerator 

EventExtensionHolder 

Flow 



FlowConstraint 



FlowConstraintCollection 
FlowConstraintEnumerator 
FlowConstraintH older 
FlowLink 



FlowLinkCollection 
FlowLinkEnumerator 
F lowL in kH older 
Function 

HasLocationsRelationship 
HasLocationsRelationshipCollec tion 



A class for enumerating a Date collection 
a class to hold Date objects 

A Device is a logical structure that supports information processing capabilities, 
for example a display device can translate a bit stream into images, a disk drive 
can store and retrieve bit streams, a keyboard can translate keystrokes into ap- 
propriate codes, a radio can select signal streams and translate them into sound. 
Document is an Item that represents content that is authored, can be rendered and 
needs to be stored. 

An eAddress is essentially a routing address, i.e., an electronic way of getting in 
touch with a person. Types of eAddresses include o Email address o Phone number 
o WebSite o FTP Site o IntemetFreebusy Location o Netmeeting settings. eAd- 
dresses may be published to allow someone to contact me - for example, I tell 
someone my phone number or email address. This contrasts with IdentityKeys, 
which are used to obtain information about someone - for example, if I want to keep 
someone's address information synchronised and up to date ; they will have to give 
me an IdentityKey that I can use to obtain the information about them from the 
server. 

A EAddress collection 

A class for enumerating a EAddress collection 
a class to hold EAddress objects 

An Item that records the occurrence of something in the environment. Currently 
being used to model Calendar-type events - this is a placeholder to be integrated 
with / replaced by the Calendar schema. 



A EventExtension collection 

A class for enumerating a EventExtension collection 
a class to hold EventExtension objects 

The Core. Flow Item type represents the graph of related tasks and their attach- 
ments: Past History, Current Tasks and Tasks not yet Started (Plan) 
The FlowConstraint type defines a constraint applicableto the relationship between 
a Task Item and a Flow Item. 
A FlowConstraint collection 

A class for enumerating a FlowConstraint collection 
a class to hold FlowConstraint objects 

the Core. FlowLink type defines the relationship between a Task and the Flow for 
that task. 

A FlowLink collection 

A class for enumerating a FlowLink collection 
a class to hold FlowLink objects 



Internal AddressLine 



InternalAddressLineCollection 

InternalAddressLineEnumerator 

InternalAddressLineHolder 

ItemCategoryRelationship 

ItemCategoryRelationshipCollec 

tion 

Keyword 

Keyword Co I lection 
Key wo rd E n u m erato r 
KeywordH older 
Location 



A wrapper around scalar string to support multi-valued strings. Used by Core. Ad- 
dress. InternalAddresses. 
A InternalAddressLineCollection 

A class for enumerating a InternalAddressLine collection 
a class to hold InternalAddressLine objects 



This type represents a keyword that can be used on a document. 
A Keyword collection 

A class for enumerating a Keyword collection 
a class to hold Keyword objects 

A Location corresponds to one physical or geographic space. A Location is a col- 
lection of "location elements", each of which independently specifies the physical 
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Location Element 
Location Report 



Location ReportCollection 
Location ReportEnumerator 
Location ReportH older 
Locations LocationElementsRel 
ationship 

Locations LocationElementsRel 
ationshipCollection 
Message 
QfficeDocument 
PreviewRelationship 
PreviewRelationshipCol lection 
PreviousVersion Relationship 
PreviousVersionRelationshipCol lection 
PublisherRelationship 
PublisherRelationshipCollection 
RichText 



space. For example, a person's current location may be alteratively specified by 
sensor data (GPS or 802.11 location elements), a postal address, or by an ID that 
resolves against a location database via a service. 
An "atom" of location information. 

The Location Report holds the data that the Location Service tags onto the Loca- 
tionElements that it produces. 
A Location Report collection 

A class for enumerating a Location Report collection 
a class to hold LocationReport objects 



Placeholder for a Message. 

Root type for all kinds of office documents like word processors, spreadsheets etc 



RichTextCollection 
RichTextEnumerator 
RichTextHolder 
RoleOccupancy 



RoleOccupancyCol lection 
RoleOccupancyEnumerator 
RoleOccupancyHolder 
Service 

ShellExtension 

Shell ExtensionCollection 

Shell Extension Enumerator 

Shell ExtensionHolder 

Task 



TaskChangeEvent 

TaskChangeEventCollection 

TaskChangeEventEnumerator 

TaskChangeEventHolder 

TaskExtension 

TaskExtensionCol lection 

TaskExtensionEnumerator 

TaskExtensionHolder 

TextDocument 



TextDocumentCollection 

TextDocumentEnumerator 

TextDocumentHolder 



A multivalued list of links pointing to any attachments associated with the entry, 
such as photos, documents, etc. In the Core schema because Core. Contact needs 
it. 

A RichText collection 

A class for enumerating a RichText collection 
a class to hold RichText objects 

This is a relationship between two Principals in which one Principal (the RoleOc- 
cupant) is the occupant of the role, and the other Principal is the context in which 
the RoleOccupancy takes place. For example a Person (the RoleOccupant) may 
be an employee (the RoleOccupancy) of an Organization (the RolesContext). 
A RoleOccupancy collection 

A class for enumerating a RoleOccupancy collection 
a class to hold RoleOccupancy objects 

The base class from which all other services are derived. Services are providers 
of information. 

Extension containing categorizing keywords. These can be attached to any item. 
A ShellExtension collection 

A class for enumerating a ShellExtension collection 
a class to hold ShellExtension objects 

A task represents unit of work that is done at a particular point in time or repeatedly 
overtime. Tasks may also be done as a result of some event otherthan the passage 
of time. Tasks are not the same as Functions. Functions are things that the system 
can do such as "Print a File" or "Backup a Directory" - Tasks record when or under 
what circumstances something should be done or has been done not what is done. 
Record of changing a Task associated with a Flow 
A TaskChangeEvent collection 

A class for enumerating a TaskChangeEvent collection 
a class to hold TaskChangeEvent objects 

A TaskExtension collection 

A class for enumerating a TaskExtension collection 
a class to hold TaskExtension objects 

This is a common type for all documents that contain texts. This includes Word 
Documents, Journal notes, etc. 
A TextDocument collection 

A class for enumerating a TextDocument collection 
a class to hold TextDocument objects 
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Triggered Event This is an event based on a calendar schedule. This happens at a certain time(s) 

of a day. 

Triggered EventCollection A TriggeredEvent collection 

Triggered EventEnumerator A class for enumerating a TriggeredEvent collection 

5 Triggered EventHolder a class to hold TriggeredEvent objects 

Uri URI. Used by the Service Item. 

UriCollection A Uri collection 

UriEnumerator A class for enumerating a Uri collection 

UriHolder a class to hold Uri objects 

10 

Interfaces 



[0106] 



Add ress E n u m erato r 



ADSynchronizationEnumerator 
AuthorCol lection 



AuthorEnumerator 



Add ressCo I lection 



ADSynchronizationCollection 



BasicPresenceCollection 



BasicPresenceEnumerator 



CalendarEventCollection 



CalendarEventEnumerator 



CategoryKeywordCollection 
CategoryKeywordEnumerator 



DateCo I lection 



DateEnumerator 



EAddressCollection 



EAddressE numerator 



EventExtension Collection 



EventExtension Enumerator 



FlowConstraintCollection 



FlowConstraintEnumerator 



FlowLinkCollection 



FlowLinkEnumerator 



Internal AddressLineCollection 



InternalAddressLineEnumerator 



Keyword Co I lection 
Keyword Enumerator 
Location ReportCollection 
Location ReportEnumerator 
RichTextCol lection 



RichTextEnumerator 



RoleOccupancyCollection 

RoleQccupancyEnumerator 

ShellExtensionCollection 



ShellExtension Enumerator 



TaskChangeEventCol lection 



TaskChangeEventEnumerator 
TaskExtensionCollection 



TaskExtension Enumerator 



TextDocumentCollection 



TextDocumentEnumerator 



TriggeredEventCollection 

TriggeredEventEnumerator 

UriCollection 



UriEnumerator 



An interface representing a Address collection 

interface representing a class for enumerating a Address collection 

An interface representing a ADSynchronization collection 

interface representing a class for enumerating a ADSynchronization collection 

An interface representing a Author collection 

interface representing a class for enumerating a Author collection 

An interface representing a BasicPresence collection 

interface representing a class for enumerating a BasicPresence collection 

An interface representing a CalendarEvent collection 

interface representing a class for enumerating a CalendarEvent collection 

An interface representing a Category Keyword collection 

interface representing a class for enumerating a Category Key word collection 

An interface representing a Date collection 

interface representing a class for enumerating a Date collection 

An interface representing a EAddress collection 

interface representing a class for enumerating a EAddress collection 

An interface representing a EventExtension collection 

interface representing a class for enumerating a EventExtension collection 

An interface representing a FlowConstraint collection 

interface representing a class for enumerating a FlowConstraint collection 

An interface representing a FlowLink collection 

interface representing a class for enumerating a FlowLink collection 

An interface representing a InternalAddressLine collection 

interface representing a class for enumerating a InternalAddressLine collection 

An interface representing a Keyword collection 

interface representing a class for enumerating a Keyword collection 

An interface representing a Location Report collection 

interface representing a class for enumerating a Location Report collection 

An interface representing a RichText collection 

interface representing a class for enumerating a RichText collection 

An interface representing a RoleOccupancy collection 

interface representing a class for enumerating a RoleOccupancy collection 

An interface representing a ShellExtension collection 

interface representing a class for enumerating a ShellExtension collection 

An interface representing a TaskChangeEvent collection 

interface representing a class for enumerating a TaskChangeEvent collection 

An interface representing a TaskExtension collection 

interface representing a class for enumerating a TaskExtension collection 

An interface representing a TextDocument collection 

interface representing a class for enumerating a TextDocument collection 

An interface representing a TriggeredEvent collection 

interface representing a class for enumerating a TriggeredEvent collection 

An interface representing a Uri collection 

interface representing a class for enumerating a Uri collection 
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Enumerations 

IdentityCardAttribute 
5 System.Storaqe.Core.lnterop 

[0107] The following table lists examples of members exposed by the System. Storage. Core. I nterop namespace. 
Interfaces 

10 

[0108] 

lAddress Address represents an address for contacting or a Contact via postal mail, or an indoor/ 

outdoor location in the Location object. 
15 lADSynchronization Synchronization parameters. 

lAuthor A link to person or company who is an author (or a co-author in case of multiple authors) 

IBasicPresence It is expected that BasicPresence will be extended. For example, supporting IRC (In- 

ternet Relay Chat) presence. An example of an IRC Presence is. - DonH = IdentityKey 
- editing some.xls = IRCPresence (what is involved is given by IRCPresence) - on 
20 some machine = eAddress (where Don is presently editing the XLS is given by eAd- 

dress) 

ICalendarEvent 

ICategorizedNestedElement A nested Element with categories field. 

I Category This represents the valid categories known to the current system. Categories (also 

25 known as taxonomies) include such things as the type values for eAddresses. 

I Category Keyword Keyword used for categorizing/grouping an item. 

ICommodity An identifiable thing that has value -this includes inanimate objects such as cars, hous- 

es, or furniture and animate objects such as pets or livestock. 

IComputer 
30 I Contact 

IContactCustom 

I Date This type represents a Date that can be used on a document. 

IDevice A Device is a logical structure that supports information processing capabilities, for 

example a display device can translate a bit stream into images, a disk drive can store 
35 and retrieve bit streams, a keyboard can translate keystrokes into appropriate codes, 

a radio can select signal streams and translate them into sound. 

IDocument Document is an Item that represents content that is authored, can be rendered and 

needs to be stored. 

I EAddress An eAddress is essentially a routing address, i.e., an electronic way of getting in touch 

40 with a person. Types of eAddresses include o Email address o Phone number o Web- 

Site o FTP Site o IntemetFreebusy Location o Netmeeting settings. eAddresses may 
be published to allow someone to contact me - for example, I tell someone my phone 
number or email address. This contrasts with IdentityKeys, which are used to obtain 
information about someone - for example, if I want to keep someone's address infor- 
ms mation synchronised and up to date, they will have to give me an IdentityKey that I 

can use to obtain the information about them from the server. 
I Event An Item that records the occurrence of something in the environment. Currently being 

used to model Calendar-type events -- this is a placeholder to be integrated with / 
replaced by the Calendar schema. 

50 lEventExtension 

IFlow The Core. Flow Item type represents the graph of related tasks and their attachments: 

Past History, Current Tasks and Tasks not yet Started (Plan) 

IFIowConstraint The FlowConstraint type defines a constraint applicable to the relationship between a 

Task Item and a Flow Item. 

55 IFIowLink the Core.FlowLink type defines the relationship between a Task and the Flow for that 

task. 

IFunction 

HnternalAddressLine A wrapper around scalar string to support multi-valued strings. Used by Core.Address. 



26 



EP 1 526 452 A2 



I Keyword 
ILocation 



ILocation Element 
ILocation Report 

IMessage 

IQfficeDocument 

IRichText 



IRoleQccupancy 



IService 



IShellExtension 
ITask 



ITaskCh an ge Event 

ITaskExtension 

ITextDocument 



ITriggered Event 
lUri 



InternalAddresses. 

This type represents a keyword that can be used on a document. 

A Location corresponds to one physical or geographic space. A Location is a collection 

of "location elements", each of which independently specifies the physical space. For 

example, a person's current location may be alteratively specified by sensor data (GPS 

or 802.11 location elements), a postal address, or by an ID that resolves against a 

location database via a service. 

An "atom" of location information. 

The Location Report holds the datathatthe Location Service tags onto the LocationEle- 
ments that it produces. 
Placeholder for a Message. 

Root type for all kinds of office documents like word processors, spreadsheets etc 
A multivalued list of links pointing to any attachments associated with the entry, such 
as photos, documents, etc. In the Core schema because Core. Contact needs it. 
This is a relationship between two Principals in which one Principal (the RoleOccupant) 
is the occupant of the role, and the other Principal is the context in which the RoleOc- 
cupancy takes place. For example a Person (the RoleOccupant) may be an employee 
(the RoleOccupancy) of an Organization (the RolesContext). 

The base class from which all other services are derived. Services are providers of 
information. 

Extension containing categorizing keywords. These can be attached to any item. 
A task represents unit of work that is done at a particular point in time or repeatedly 
overtime. Tasks may also be done as a result of some event other than the passage 
of time. Tasks are not the same as Functions. Functions are things that the system 
can do such as "Print a File" or "Backup a Directory" - Tasks record when or under 
what circumstances something should be done or has been done not what is done. 
Record of changing a Task associated with a Flow 

This is a common type for all documents that contain texts. This includes Word Doc- 
uments, Journal notes, etc. 

This is an event based on a calendar schedule. This happens at a certain time(s) of a 
day. 

URI. Used by the Service Item. 



System.Storage.Explorer 

[0109] The following tables list examples of members exposed by the System.Storage.Explorer namespace. 

Classes 

[0110] 



AuditEvent 

AuditEventElement 

AuditEventElementCol lection 

AuditEventElementEnumerator 

AuditEventElementHolder 

History 

History Down load 

HistoryDownloadCollection 

HistoryDownloadEnumerator 

HistoryDownloadHolder 

HistoryElement 

History ElementCollection 

History ElementEnumerator 

History ElementHolder 

History Visit 

HistoryVisitCollection 



A AuditEventElement collection 

A class for enumerating a AuditEventElement collection 
a class to hold AuditEventElement objects 



A HistoryDownload collection 

A class for enumerating a HistoryDownload collection 
a class to hold HistoryDownload objects 

A HistoryElement collection 

A class for enumerating a HistoryElement collection 
a class to hold HistoryElement objects 



A HistoryVisit collection 
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H istory VisitE n umerator 

History VisitH older 

InternetShortcut 

Share 

Thumbnail 

ThumbnailCache 

ThumbnailCacheCol lection 

ThumbnailCacheEnumerator 

ThumbnailCacheHolder 

Us age Pattern 

UsagePattern Entry 

UsagePatternEntryCollection 
UsagePattern Entry Enumerator 
UsagePattern EntryHolder 



A class for enumerating a HistoryVisit collection 
a class to hold HistoryVisit objects 



A ThumbnailCache collection 

A class for enumerating a ThumbnailCache collection 
a class to hold ThumbnailCache objects 

UsagePattern item is type of folder that contains usage pattern entries. It also con- 
tains max number of entries. 

Link to item that is remembered in usage pattern. Also contains deep copy of prop- 
erty that is being remembered. 
A UsagePattern Entry collection 

A class for enumerating a UsagePattern Entry collection 
a class to hold UsagePattemEntry objects 



Interfaces 



[0111] 



lAuditEventElementCollection 

I AuditEventElementEn umerator 

lEqualityComparer 

IHistoryDownloadCollection 

IHistoryDownloadEn umerator 

IHistoryElementCollection 

IHistoryElementEnumerator 

I H istory VisitCol lection 

IHistoryVisitEnumerator 

IThumbnailCacheCollection 

IThumbnailCacheEn umerator 

lUsagePatternEntryCollection 

lUsagePatternEntryEnumerator 



An interface representing a AuditEventElement collection 

interface representing a class for enumerating a AuditEventElement collection 

An interface representing a HistoryDownload collection 

interface representing a class for enumerating a HistoryDownload collection 

An interface representing a HistoryElement collection 

interface representing a class for enumerating a HistoryElement collection 

An interface representing a HistoryVisit collection 

interface representing a class for enumerating a HistoryVisit collection 

An interface representing a ThumbnailCache collection 

interface representing a class for enumerating a ThumbnailCache collection 

An interface representing a UsagePattemEntry collection 

interface representing a class for enumerating a UsagePattemEntry collection 



System-Storage. Explorer.lnterop 

[0112] The following table lists examples of members exposed by the System. Storage. Explorer. I nterop namespace. 
Interfaces 



[0113] 

lAuditEvent 

I AuditEventElement 

IHistory 

IHistoryDownload 

IHistoryElement 

IHistoryVisit 

I InternetShortcut 

IShare 

IThumbnail 

IThumbnailCache 

lUsagePattern UsagePattern item is type of folder that contains usage pattern entries. It also contains max 

number of entries. 

lUsagePattern Entry Link to item that is remembered in usage pattern. Also contains deep copy of property that is 
being remembered. 
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S y s te m . Sto rag e . Fax 

[0114] The following tables list examples of members exposed by the System. Storage. Fax namespace. 
5 Classes 
[0115] 

FaxAccount 
10 FaxAccountProperties 

FaxAccountPropertiesCollection 

FaxAccountPropertiesEnumerator 

FaxAccountPropertiesHolder 

FaxAccountServer 
15 FaxAccountServerCol lection 

FaxAccountServerEnumerator 

FaxAccountServerHolder 

FaxCoverPagelnfo 

FaxCoverPagelnfoCollection 
20 FaxCoverPagelnfoEnumerator 

FaxCoverPagelnfoHolder 

FaxFolder 

FaxMessage 

FaxParticipant 
25 FaxParticipantCollection 

FaxParticipantEnumerator 

FaxParticipantHolder 

TransmissionDetails 

TransmissionDetailsCollection 
30 TransmissionDetailsE numerator 

TransmissionDetailsH older 

Interfaces 

35 [0116] 

I FaxAccountPropertiesCollection 

I FaxAccountPropertiesEnumerator 

I FaxAccountServerCollection 
40 I FaxAccountServerEnumerator 

I FaxCoverPagelnfoCollection 

I FaxCoverPagelnfoEnumerator 

I FaxParticinantCollection 

I FaxParticinantEnumerator 
45 [Transmission PetailsCollection 

ITransmissionDetailsEnumerator 

Sy ste m . Sto rag e , Fax . I n te ro p 

50 [0117] The following table lists examples of members exposed by the System.Storage.Fax.lnterop namespace. 
Interfaces 
[0118] 

55 

I FaxAccount 

I FaxAccountProperties 

I FaxAccountServer 
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IFaxCoverPagelnfo 
IFaxFolder 
IFaxMessage 
IFaxParticipant 
ITransmission Details 

System-Storage. Files 

[0119] The following table lists examples of members exposed by the System. Storage. Files namespace. 

Classes 

[0120] 

File File type encapsulates the metadata/properties of files. 
System.Storage.Files.lnterop 

[0121] The following table lists examples of members exposed by the System.Storage.Files.lnterop namespace. 

Interfaces 

[0122] 

I File File type encapsulates the metadata/properties of files. 
System.Storage.GameLibrary 

[0123] The following table lists examples of members exposed by the System.Storage.GameLibrary namespace. 

Classes 

[0124] 

GameDescription The GameDescription type describes the metadata that is retrieved and stored from a game de- 
scription file (GDF) 

Svstem.Storaae.GameLibrarv.lnterop 

[0125] The following table lists examples of members exposed by the System.Storage.GameLibrary. I nterop name- 
space. 

Interfaces 

[0126] 

IGameDescription The GameDescription type describes the metadata that is retrieved and stored from a game 
description file (GDF) 

Svstem.Storaqe.HelR 

[0127] The following tables list examples of members exposed by the System. Storage. Help namespace. 

Classes 

[0128] 

Bundle A Bundle is a virtual collection of Help Topics. It is uniquely identified by the Name inside the 



30 



10 



15 



20 



BundleCollection 

BundleEnumerator 

BundleHolder 
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current product. Each Topic inside a Bundle is uniquely identified by its partial Url (SubUrl). 
A Bundle collection 

A class for enumerating a Bundle collection 
a class to hold Bundle objects 

A HelpFile is a physical file that contains Help Topics. 



HelpFile 
HelpFileTopicLinkRelationship 
HelpFileTopicLinkRelationshipCollection 

Product The top-level owner of all Help Bundles and HelpFiles. It maps to the Help content of real prod- 

ucts. 

ProductHelpFileLinkRelationship 
ProductHelpFileLinkRelationshipCollection 

Topic A Topic is a Help primitive that the user can search on and view the content. 

Interfaces 



[0129] 

IBundleCollection 
IBundleEnumerator 



An interface representing a Bundle collection 

interface representing a class for enumerating a Bundle collection 



Svstem.Storaae.Help.lnterop 

[0130] The following table lists examples of members exposed by the System. Storage. Help. Interop namespace. 



25 Interfaces 



[0131] 



30 



35 



IBundle A Bundle is a virtual collection of Help Topics. It is uniquely identified by the Name inside the current 

product. Each Topic inside a Bundle is uniquely identified by its partial Url (SubUrl). 
IHelpFile A HelpFile is a physical file that contains Help Topics. 

I Product The top-level owner of all Help Bundles and HelpFiles. It maps to the Help content of real products. 
ITopic A Topic is a Help primitive that the user can search on and view the content. 

System .Storage. Image 

[0132] The following table lists examples of members exposed by the System. Storage. Image namespace. 



40 



45 



50 



55 



Classes 
[0133] 

AnalysisProperties 



Analysis PropertiesCollection 
Analysis Properties Enumerator 
AnalysisPropertiesHolder 
EventReference 

EventReferenceCollection 
EventReferenceEnumerator 
EventReferenceH older 
Image 

Location Reference 



A set of properties that are calculated on the photo by an analysis application. This 
extension should be applied to the Image items that have been passes through the 
analysis application. These properties are more of a cache, but they are expensive 
to recompute. These fields are application specific. Other applications may not un- 
derstand the internal format of these fields. 
A AnalysisProperties collection 

A class for enumerating a AnalysisProperties collection 
a class to hold AnalysisProperties objects 

EventReference type represents a linkto an Event Item. It may be dangling, in which 
case the fields on this type specify the name of the event. 
A EventReference collection 

A class for enumerating a EventReference collection 
a class to hold EventReference objects 

Location Reference type represents a linkto a Location item. It may be dangling, in 
which case the fields on this type specify the location coordinates. 
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Location ReferenceCollection 
Location ReferenceE numerator 
Location ReferenceHolder 
Person Reference 



Person ReferenceCollection 
Person ReferenceE numerator 
Person ReferenceHolder 
Photo 
Region 

RegionCollection 
Region Enumerator 
Region Holder 
RegionQflnterest 
RegionQf Interested lection 
Reg i o n Of I nt e r est E n u m e rato r 
RegionQf Interestholder 

Interfaces 



A Location Reference collection 

A class for enumerating a Location Reference collection 
a class to hold LocationReference objects 

PersonReference type represents a link to a Contact Item. It may be dangling, in 
which case the fields on this type specify the name of the person. 
A PersonReference collection 

A class for enumerating a PersonReference collection 
a class to hold PersonReference objects 

A set of properties describing a Photo if the picture is actually a Photograph. 
This type represents a region in an Image. 
A Region collection 

A class for enumerating a Region collection 
a class to hold Region objects 

A RegionOf Interest collection 

A class for enumerating a RegionOf Interest collection 
a class to hold RegionQflnterest objects 



[0134] 

lAnalysisPropertiesCollection 
I AnalysisProperties Enumerator 
I EventReferenceCol lection 
lEventReferenceEnumerator 
ILocation ReferenceCollection 
ILocationReferenceEnumerator 
IPersonReferenceCollection 
IPersonReferenceEnumerator 
IRegionCollection 
IRegionEnumerator 
IRegionOflnterestCollection 
I RegionOf I nte rest Enumerator 



An interface representing a AnalysisProperties collection 

interface representing a class for enumerating a AnalysisProperties collection 

An interface representing a EventReference collection 

interface representing a class for enumerating a EventReference collection 

An interface representing a LocationReference collection 

interface representing a class for enumerating a LocationReference collection 

An interface representing a PersonReference collection 

interface representing a class for enumerating a PersonReference collection 

An interface representing a Region collection 

interface representing a class for enumerating a Region collection 

An interface representing a RegionOf Interest collection 

interface representing a class for enumerating a RegionQflnterest collection 



System .Storage. Image. Interop 

[0135] The following table lists examples of members exposed by the System. Storage. Image. Interop namespace. 
Interfaces 



[0136] 

I AnalysisProperties 

I EventReference 
llmage 

ILocation Reference 

I Person Reference 

I Photo 
IRegion 



A set of properties that are calculated on the photo by an analysis application. This extension 
should be applied to the Image items that have been passes through the analysis application. 
These properties are more of a cache, but they are expensive to recompute. These fields are 
application specific. Other applications may not understand the internal format of these fields. 
EventReference type represents a link to an Event Item. It may be dangling, in which case the 
fields on this type specify the name of the event. 

This is a base type that is shared by all Images. It contains fields that describe image in general 
and are applicable to images stored in different formats. 

Location Reference type represents a link to a Location item. It may be dangling, in which case 
the fields on this type specify the location coordinates. 

PersonReference type represents a link to a Contact Item. It may be dangling, in which case 
the fields on this type specify the name of the person. 

A set of properties describing a Photo if the picture is actually a Photograph. 
This type represents a region in an Image. 
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I RegionOf Interest 
System .Storage. Interop 

[0137] The following tables list examples of members exposed by the System. Storage. Interop namespace. 

Classes 

[0138] 

Convert Summary description for Convert. 
Interfaces 



[0139] 

ICategoryRef 

lExtension 

lExtensionCustom 
IFolder 
HdentityKey 
litem 

MtemContext 

NtemCustom 
MtemName 
MtemNameCollection 
MtemNameEnumerator 
ILink 

INestedElement 
I Projection Opt ion 

IQuery 

IRecycleBinLink 
I Search Projection 

I Share 

IStorageExceptionlnformation 

IStore 

IVolume 

System .Storage. Image 

[0140] The following tables list examples of members exposed by the System. Storage. Image namespace. 
Classes 



A Category reference Identity key. Every categoryNode has an identity key of type Catego- 
ryRef. When category refences are tagged onto an item, they are tagged as a link type 
where the Link.Target contains a CategoryRef. 

This is the type used as the basis for extensions. To establish an extension a new subtype 
of this type is defined. The extension may be added to an Item by creating an instance of 
the type and assigning it to the Extensions field of the Item to be extended. 
Custom methods for the Extension class 



This interface exposes methods on the COM Callerable Wrapper for the ItemContext class 
used in COM interop. 

Custom methods and properties for the Item object 
ItemName represents the path name of an item 
An ItemNameCollection contains all the item names for an item 
interface representing a class for enumerating a ItemName collection 



This interface defines methods of the COM Callerable Wrapper for the ProjectionOption 
class used in the COM interop. 

This interface exposes methods on the COM Callerable Wrapper for the Query class used 
in COM interop. 

This interface defines the methods for the COM Callerable Wrapper, Search Projection, used 
in the COM interop. 



[0141] 

Analysis Properties 



A set of properties that are calculated on the photo by an analysis application. This 
extension should be applied to the Image items that have been passes through the 
analysis application. These properties are more of a cache, but they are expensive 
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Analysis PropertiesCollection 
Analysis Properties Enumerator 
Analysis Properties Holder 
EventReference 

EventReferenceCollection 
EventReferenceEnumerator 
EventReferenceH older 
Image 

Location Reference 

Location ReferenceCollection 
Location ReferenceEnumerator 
Location ReferenceHolder 
Person Reference 



Person ReferenceCollection 
Person ReferenceEnumerator 
Person ReferenceHolder 
Photo 
Region 

RegionCollection 

Region Enumerator 

RegionHolder 

RegionOflnterest 

RegionOflnterestCol lection 

Region Of InterestEnumerator 

RegionOflnterestHolder 

Interfaces 



[0142] 

lAnalysisPropertiesCollection 
I AnalysisProperties Enumerator 
I EventReferenceCollection 
I EventReferenceEnumerator 
ILocation ReferenceCollection 
ILocation ReferenceEnumerator 
I PersonReferenceCol lection 
IPersonReferenceEnumerator 
IRegionCollection 
IRegionEnumerator 
IRegionOflnterestCollection 
I RegionQf InterestEnumerator 



to recompute. These fields are application specific. Other applications may not un- 
derstand the internal format of these fields. 
A AnalysisProperties collection 

A class for enumerating a AnalysisProperties collection 
a class to hold AnalysisProperties objects 

EventReference type represents a link to an Event Item. It may be dangling, in which 
case the fields on this type specify the name of the event. 
A EventReference collection 

A class for enumerating a EventReference collection 
a class to hold EventReference objects 

Location Reference type represents a link to a Location item. It may be dangling, in 
which case the fields on this type specify the location coordinates. 
A Location Reference collection 

A class for enumerating a Location Reference collection 
a class to hold Location Reference objects 

PersonReference type represents a link to a Contact Item. It may be dangling, in 
which case the fields on this type specify the name of the person. 
A PersonReference collection 

A class for enumerating a PersonReference collection 
a class to hold PersonReference objects 

A set of properties describing a Photo if the picture is actually a Photograph. 
This type represents a region in an Image. 
A Region collection 

A class for enumerating a Region collection 
a class to hold Region objects 

A RegionOflnterest collection 

A class for enumerating a RegionOflnterest collection 
a class to hold RegionOflnterest objects 



An interface representing a AnalysisProperties collection 

interface representing a class for enumerating a AnalysisProperties collection 

An interface representing a EventReference collection 

interface representing a class for enumerating a EventReference collection 

An interface representing a Location Reference collection 

interface representing a class for enumerating a Location Reference collection 

An interface representing a PersonReference collection 

interface representing a class for enumerating a PersonReference collection 

An interface representing a Region collection 

interface representing a class for enumerating a Region collection 

An interface representing a RegionOflnterest collection 

interface representing a class for enumerating a RegionOflnterest collection 
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System.Storage.lmage.lnterop 

[0143] The following table lists examples of members exposed by the System.Storage.lmage.lnterop namespace. 
Interfaces 



[0144] 

lAnalysisProperties 

lEventReference 
llmage 

ILocation Reference 
I Person Reference 
I Photo 



A set of properties that are calculated on the photo by an analysis application. This extension 
should be applied to the Image items that have been passes through the analysis application. 
These properties are more of a cache, but they are expensive to recompute. These fields are 
application specific. Other applications may not understand the internal format of these fields. 

EventReference type represents a link to an Event Item. It may be dangling, in which case the 
fields on this type specify the name of the event. 

This is a base type that is shared by all Images. It contains fields that describe image in general 
and are applicable to images stored in different formats. 

Location Reference type represents a link to a Location item. It may be dangling, in which case 
the fields on this type specify the location coordinates. 

Person Reference type represents a link to a Contact Item. It may be dangling, in which case 
the fields on this type specify the name of the person. 

A set of properties describing a Photo if the picture is actually a Photograph. 
This type represents a region in an Image. 



IRegion 
I RegionQf Interest 
Sy ste m . Sto rag e . I nte ro p 

[0145] The following tables list examples of members exposed by the System. Storage. Interop namespace. 
Classes 



[0146] 

Convert Summary description for Convert. 

Interfaces 

[0147] 

ICategoryRef A Category reference Identity key. Every category Node has an identity key of type Catego- 

ryRef. When category refences are tagged onto an item, they are tagged as a link type 
where the Link.Target contains a CategoryRef. 

lExtension This is the type used as the basis for extensions. To establish an extension a new subtype 

of this type is defined. The extension may be added to an Item by creating an instance of 
the type and assigning it to the Extensions field of the Item to be extended. 

lExtensionCustom Custom methods for the Extension class 

IFolder 

MdentityKey 

litem 

NtemContext This interface exposes methods on the COM Callerable Wrapper for the ItemContext class 

used in COM interop. 
MtemCustom Custom methods and properties for the Item object 
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NtemName 
NtemNameCollection 
NtemNameEnumerator 
ILink 

INestedElement 
I Projection Opt ion 

IQuery 

IRecycleBinLink 
ISearchProjection 



ItemName represents the path name of an item 

An ItemNameCollection contains all the item names for an item 

interface representing a class for enumerating a ItemName collection 



This interface defines methods of the COM Callerable Wrapper for the ProjectionOption 
class used in the COM interop. 

This interface exposes methods on the COM Callerable Wrapper for the Query class used 
in COM interop. 

This interface defines the methods for the COM Callerable Wrapper, Search Projection, used 
in the COM interop. 



I Share 

IStorageException Information 

IStore 

IVolume 



Svstem.Storaae.Location 

[0148] The following tables list examples of members exposed by the System. Storage. Location namespace. 



Classes 



[0149] 



Address Address represents an address for contacting a Contact via postal mail, or an 

indoor/outdoor location in the Location object. 

Angle3D Angle3D represents a one-element, two-element, or three-element vector of an- 

gle values. The elements are of type float or NULL (corresponding to CLR double 
and NaN, respectively). The angle vector may be used to represent data like 
bearing (1-D), spherical coordinates (2-D), or (roll, pitch ; yaw) values (3-D). 

Angle3DCollection A Angle3D collection 

Angle3D Enumerator A class for enumerating a Angle3D collection 

Angle3DHolder a class to hold Angle3D objects 

CoordinateReferenceSystem CoordinateReferenceSystem is used to explicitly identify the coordinate refer- 

ence system and datum that is used. In nearly all cases, MS applications and 
implementations will standardize on WGS84 datum, geographic projection, dec- 
imal degree coordinate representations as the basis for transferring locations 
between applications. Internally, other coordinate systems could be used for 
performance reasons and graphic representations will almost certainly use a 
different projection and perhaps different units. The CoordinateReferenceSys- 
tem type has been designed to match the current LIF MLP 3.0 encoding for 
WGS84. Note that for an engineering coordinate system (such as a floor of a 
building), the Code, CodeSpace, and Edition indicate an "unknown" coordinate 
system. In this case, the EngineeringReference field is used to link to an Entit- 
y Reference for the entity that defines the coordinate system. For example, a 
floor of a building has an Entity Reference and a CoordinateReferenceSystem. 
Each Position defined on that floor will specify as its CoordinateSystem a link 
to the CoordinateReferenceSystem for the floor. 

EnaineeringRefs Entity Relations hip 
EngineeringRefsEntity Relations hipCollection 

Entity Reference This represents a reference to an entity. An entity is a place (continent, country, 

city, neighborhood, river, etc..) or space (building, floor, room, parking spot, cu- 
bicle) that is uniquely identified within a named data source. For example, Map- 
Point provides the definitions for certain data source. Within the North America 
data source, the Space Needle is "1424488", Texas is "33145", and postcode 
98007 is "154012087". In order to have the entity identifiers make sense, they 



36 



EP 1 526 452 A2 



Ieee802dot1 1 



Location Profile 



Matrix3x3 



Matrix3x3Co I lection 
Matrix3x3 Enumerator 
Matrix3x3 Holder 
NamedLocation 



NonScalarStringl 024 
NonScalarStringl 024Collection 
NonScalarString 1 024Enumerat or 
NonScalarStringl 024Holder 
ParentRelationship 
ParentRelationshipCollection 
Position 
Position3D 



Position3DCol lection 
Position3DEnumerator 
Position3DHolder 
PositionsCoordinateSystemRela tionship 
PositionsCoordinateSystemRela tionshipCollection 



are related to the data source provider at http://www.microsoft.com/MapPoint. 
There are hierarchies of Entities, such as City --> Adminl --> Country; or Building 
— > Floor --> Room. 

This is used to provide information about an 802.11 access point, including it's 
MAC address and signal strength (RSSI). 

Location Profile describes a set of location elements that pertains to a location. 
It has a userlD, an application ID, a context and a relationship to the Core. Lo- 
cation item (a collection of location elements). A profile may be created because 
an application running in a particular user context cares about a location and 
wants to be notified when the user reaches that location. A profile may just be 
transient in the sense that it was created by the location service on behalf of the 
user and cached in "WinFS". 

Matrix3x3 represents a 3x3 matrix of floats. Any of the matrix elements may be 
NULL. 

A Matrix3x3 collection 

A class for enumerating a Matrix3x3 collection 
a class to hold Matrix3x3 objects 

Represents a user-inputted friendly name that can be associated with a location. 

The value is stored in the Item.DisplayName. 

A wrapper around scalar string to support multi-valued strings. 

A NonScalarStringl 024 collection 

A class for enumerating a NonScalarStringl 024 collection 
a class to hold NonScalarStringl 024 objects 



This is used to provide position information. 

Position3D represents a one-element, two-element, or three-element vector of 
(x,y,z) position values. The elements are of type float or NULL (corresponding 
to CLR double and NaN, respectively). 
A Position3D collection 

A class for enumerating a Position3D collection 
a class to hold Position3D objects 



PositionUncertainty 
Position UncertaintyCollection 
Position UncertaintyEnumerator 
Position UncertaintyHolder 
Prof ileLocation Relationship 
ProfileLocationRelationshipCol lection 
SimpleUncertainty 
SimpleUncertaintyCollection 
SimpleUncertaintyEnumerator 
SimpleUncertaintyHolder 
StatisticalUncertainty 



Abstract type to represent types of position uncertainty. 
A PositionUncertainty collection 

A class for enumerating a PositionUncertainty collection 
a class to hold PositionUncertainty objects 



StatisticalUncertaintyCollection 
StatisticalUncertainty En umerat or 
StatisticalUncertaintyHolder 



Simple uncertainty represents uncertainty as a single value. 
A SimpleUncertainty collection 

A class for enumerating a SimpleUncertainty collection 
a class to hold SimpleUncertainty objects 

The uncertainty in (x,y,z) is represented by a 3x3 covariance matrix. The main 
diagonal of the matrix, c[0][0], c[1][1]. and c[2][2], represents the statistical var- 
iances of x, y, and z respectively. A variance is the square of the standard de- 
viation. The off-diagonal elements represent the covariance of different pairings 
of x, y, and z. Mathematically the covariance matrix represents the expected 
deviations (dx,dy,dz) from a position. The covariance matrix specifically gives 
the expected values of the products of the deviations: [ c[0][0] c[0][1] c[0][2] ] [ 
c[1][0] c[1][1] c[1][2] ] [ c[2][0] c[2][1] c[2][2] ] [ E[dx*dx] E[dx*dy] E[dx*dz] ] [ E 
[dx*dy] E[dy*dy] E[dy*dz] ] [ E[dx*dz] E[dy*dz] E[dz*dz] ] where E[ ... ] means 
expected value. Note that the covariance matrix is symmetric around the main 
diagonal. 

A StatisticalUncertainty collection 

A class for enumerating a StatisticalUncertainty collection 
a class to hold StatisticalUncertainty objects 
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Interfaces 
[0150] 

5 IAngle3DCollection 

IAngle3D Enumerator 

IMatrix3x3Collection 

I M atrix3x3 E n u merator 

INonScalarStringl 024Collection 
10 INonScalarStringl 024Enumerator 

IPosition3DCollection 

IPosition3DEnunnerator 

I Position UncertaintyCollection 

I Position Uncertainty Enumerator 
15 ISimpleUncertaintyCollection 

ISimpleUncertaintyEnumerator 

IStatisticalUncertaintyCollection 

IStatisticalUncertainty Enumerator 

20 System. Storage-Location .Interop 

[0151] The following table lists examples of members exposed by the System. Storage. Location. Interop namespace. 
Interfaces 

25 

[0152] 

I Ad dress Address represents an address for contacting a Contact via postal mail, or an indoor/ 

outdoor location in the Location object. 

30 IAngle3D Angle3D represents a one-element, two-element, or three-element vector of angle 

values. The elements are of type float or NULL (corresponding to CLR double and 
NaN, respectively). The angle vector may be used to represent data like bearing 
(1-D), spherical coordinates (2-D), or (roll, pitch, yaw) values (3-D). 
ICoordinateReferenceSystem CoordinateReferenceSystem is used to explicitly identify the coordinate reference 

35 system and datum that is used. In nearly all cases, MS applications and implemen- 

tations will standardize on WGS84 datum, geographic projection, decimal degree 
coordinate representations as the basis for transferring locations between applica- 
tions. Internally, other coordinate systems could be used for performance reasons 
and graphic representations will almost certainly use a different projection and per- 

40 haps different units. The CoordinateReferenceSystem type has been designed to 

match the current LIF MLP 3.0 encoding for WGS84. Note that for an engineering 
coordinate system (such as a floor of a building), the Code, CodeSpace, and Edition 
indicate an "unknown" coordinate system. In this case, the EngineeringReference 
field is used to link to an EntityReference for the entity that defines the coordinate 

45 system. For example, a floor of a building has an EntityReference and a Coordina- 

teReferenceSystem. Each Position defined on that floor will specify as its Coordina- 
teSystem a link to the CoordinateReferenceSystem for the floor. 
I EntityReference This represents a reference to an entity. An entity is a place (continent, country, city, 

neighborhood, river, etc..) or space (building, floor, room, parking spot, cubicle) that 

50 is uniquely identified within a named data source. For example, MapPoint provides 

the definitions for certain data source. Within the North America data source, the 
Space Needle is "1424488", Texas is "33145", and postcode 98007 is " 154012087". 
In orderto have the entity identifiers make sense, they are related to the data source 
provider at http://www.microsoft.com/MapPoint. There are hierarchies of Entities, 

55 such as City -> Adminl --> Country; or Building --> Floor --> Room. 

Ileee802dot 1 1 This is used to provide information about an 802.11 access point, including it's MAC 

address and signal strength (RSSI). 
ILocation Profile Location Profile describes a set of location elements that pertains to a location. It has 



An interface representing a Angle3D collection 

interface representing a class for enumerating a Angle3D collection 

An interface representing a Matrix3x3 collection 

interface representing a class for enumerating a Matrix3x3 collection 

An interface representing a NonScalarStringl 024 collection 

interface representing a class for enumerating a NonScalarString 1 024 collection 

An interface representing a Position3D collection 

interface representing a class for enumerating a Position3D collection 

An interface representing a PositionUncertainty collection 

interface representing a class for enumerating a PositionUncertainty collection 

An interface representing a SimpleUncertainty collection 

interface representing a class for enumerating a SimpleUncertainty collection 

An interface representing a StatisticalUncertainty collection 

interface representing a class for enumerating a StatisticalUncertainty collection 
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5 

IMatrix3x3 

I Named Location 

INonScalarString 1024 
10 IPosition 

IPosition3D 



IPositionUncertainty 
15 ISimpleUncertainty 

IStatisticalUncertainty 



20 



25 

System .Storage .Mai I 

[0153] The following table lists examples of members exposed by the System. Storage. Mai I namespace. 

30 

Classes 

[0154] 

35 ArticleRange 
Folder 
Message 

System. Storage. Mail.lnterop 

40 ' ^ 

[0155] The following table lists examples of members exposed by the System. Storage. Mail.lnterop namespace. 
Interfaces 
^5 IMessage 

S y ste m . Sto rag e . Med ia 

[0156] The following tables list examples of members exposed by the System. Storage. Media namespace. 

50 

Classes 
[0157] 

55 CategoryRef Temporary placeholder category reference type 

CategoryRefCollection A CategoryRef collection 

CategoryRefEnumerator A class for enumerating a CategoryRef collection 

CategoryRef Holder a class to hold CategoryRef objects 



a userlD, an application ID, a context and a relationship to the Core. Location item (a 
collection of location elements). A profile may be created because an application 
running in a particular user context cares about a location and wants to be notified 
when the user reaches that location. A profile may just be transient in the sense that 
it was created by the location service on behalf of the user and cached in "WinFS". 
Matrix3x3 represents a 3x3 matrix of floats. Any of the matrix elements may be NULL. 
Represents a user-inputted friendly name that can be associated with a location. The 
value is stored in the Item.DisplayName. 
A wrapper around scalar string to support multi-valued strings. 
This is used to provide position information. 

Position3D represents a one-element, two-element, or three-element vector of (x.y, 
z) position values. The elements are of type float or NULL (corresponding to CLR 
double and NaN, respectively). 

Abstract type to represent types of position uncertainty. 
Simple uncertainty represents uncertainty as a single value. 

The uncertainty in (x,y,z) is represented by a 3x3 covariance matrix. The main diag- 
onal of the matrix, c[0][0], c[1][1], and c[2][2], represents the statistical variances of 
x, y, and z respectively. A variance is the square of the standard deviation. The off- 
diagonal elements represent the covariance of different pairings of x, y, and z. Math- 
ematically the covariance matrix represents the expected deviations (dx,dy,dz) from 
a position. The covariance matrix specifically gives the expected values of the prod- 
ucts of the deviations: [ c[0] [0] c[0][1 ] c[0][2] ] [ c[1 ][0] c[1 ][1 ] c[1 ][2] ] [ c[2][0] c[2][1 ] 
c[2][2] ] [ E[dx*dx] E[dx*dy] E[dx*dz] ] [ E[dx*dy] E[dy*dy] E[dy*dz] ] [ E[dx*dz] E 
[dy*dz] E[dz*dz] ] where E[ ... ] means expected value. Note that the covariance ma- 
trix is symmetric around the main diagonal. 
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Custom Rating 

CustomRatingCollection 
CustomRating Enumerator 
CustomRatingHolder 
Distributor 



DistributorCollection 
DistributorEnumerator 
DistributorHolder 
Document 

History 

HistoryCollection 

HistoryEnumerator 

HistoryHolder 

M etad ata L if ecy c I e 

MetadataL if ecycleCollection 

M etad ata L if ecy c I e E n u m e rato r 

MetadataLifecycleHolder 

Rating 



RatingCollection 
RatingEnumerator 
RatingHolder 
StarRating 

StarRatingCollection 
StarRating Enumerator 
StarRatingHolder 
Url Reference 

UrIReferenceCollection 

UrIReferenceEnumerator 

UrIReferenceHolder 

Interfaces 

[0158] 

I Category Ref Col lection 

ICategoryRef Enumerator 

ICustom RatingCollection 

ICustom RatingEnumerator 

IDistributorCollection 

IDistributorEnumerator 

I HistoryCollection 

I H isto ry En u merator 

I MetadataLif ecycleCollection 

IMetadataLifecycleEnumerator 

IRatingCollection 

IRatingEnumerator 

IStarRatingCollection 



CustomRating type represents a free-form string rating given to the media document 

by some authority. 

A CustomRating collection 

A class for enumerating a CustomRating collection 
a class to hold CustomRating objects 

Distributor type represents a link to a Contact item for Content Distributor for Media 
information. May be dangling in which case the fields on this type specify the distrib- 
utor. 

A Distributorcollection 

A class for enumerating a Distributor collection 
a class to hold Distributor objects 

The type Media. Document represents audio documents such as tracks, albums, etc. 
It contains fields that are common for all documents. 

History type represents a history of this media document. When and how did I edit 
it? Who did i mail it to? Did I rotate it? Did I apply filters? 
A History collection 

A class for enumerating a History collection 
a class to hold History objects 
Metadata (lifecycle and other state tracking). 
A Metadata Lifecycle collection 

A class for enumerating a MetadataLifecycle collection 
a class to hold MetadataLifecycle objects 

Rating type represents a rating given to the media document by some authority. The 
authority cold be MPAA, Microsoft, or even myself. There are two types of ratings: 
string rating and numeric rating. To represent these cases people should create an 
instance of Custom rating or StarRating types. The Rating type itself does not contain 
the value of the rating, so it is an abstract type. 
A Rating collection 

A class for enumerating a Rating collection 
a class to hold Rating objects 

StarRating type represents a numeric rating given to the media document by some 
authority. 

A StarRating collection 

A class for enumerating a StarRating collection 
a class to hold StarRating objects 

UrIReference type represents an URL together with a category that specifies what 

kind of URL is it. 

A UrIReference collection 

A class for enumerating a UrIReference collection 
a class to hold UrIReference objects 



An interface representing a CategoryRef collection 

interface representing a class for enumerating a CategoryRef collection 

An interface representing a CustomRating collection 

interface representing a class for enumerating a CustomRating collection 

An interface representing a Distributorcollection 

interface representing a class for enumerating a Distributor collection 

An interface representing a History collection 

interface representing a class for enumerating a History collection 

An interface representing a MetadataLifecycle collection 

interface representing a class for enumerating a MetadataLifecycle collection 

An interface representing a Rating collection 

interface representing a class for enumerating a Rating collection 

An interface representing a StarRating collection 
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IStarRatingE numerator interface representing a class for enumerating a StarRating collection 

lUrlReferenceCollection An interface representing a UrIReference collection 

lUrlReferenceEnumerator interface representing a class for enumerating a UrIReference collection 

System-Storage. Media. Interop 

[0159] The following table lists examples of members exposed by the System. Storage. Media. Interop namespace. 



Interfaces 



[0160] 

ICategoryRef Temporary placeholder category reference type 

ICustom Rating CustomRating type represents a free-form string rating given to the media document by some 

authority. 

I Distributor Distributor type represents a link to a Contact item for Content Distributor for Media information. 

May be dangling in which case the fields on this type specify the distributor. 
IDocument The type Media. Document represents audio documents such as tracks, albums, etc. It contains 

fields that are common for all documents. 
I History History type represents a history of this media document. When and how did I edit it? Who did 

i mail it to? Did I rotate it? Did I apply filters? 
I M etadataLifecycle Metadata (lifecycle and other state tracking). 

IRating Rating type represents a rating given to the media document by some authority. The authority 

cold be MPAA, Microsoft, or even myself. There are two types of ratings: string rating and numeric 
rating. To represent these cases people should create an instance of Custom rating or StarRating 
types. The Rating type itself doe s not contain the value of the rating, so it is an abstract type. 

IStarRating StarRating type represents a numeric rating given to the media document by some authority. 

lUrlReference UrIReference type represents an URL together with a category that specifies what kind of URL 

is it. 



System.Storage.Meta 

[0161] The following tables list examples of members exposed by the System.Storage.Meta namespace. 



Classes 



[0162] 



BuiltlnField 

BuiltlnFieldCollection 

BuiltlnFieldEnumerator 

BuiltlnFieldHolder 

BuiltlnType 

ElennentType 

Field 

FieldCollection 
FieldEnumerator 
FieldHolder 
Index 

IndexCollection 

IndexEnumerator 

IndexField 

IndexFieldCollection 

IndexField Enumerator 

IndexFieldHolder 

IndexHolder 

Nested Field 

NestedFieldCollection 



A BuiltlnField collection 

A class for enumerating a BuiltlnField collection 
a class to hold BuiltlnField objects 



A Field collection 

A class for enumerating a Field collection 
a class to hold Field objects 

A Index collection 

A class for enumerating a Index collection 
A IndexField collection 

A class for enumerating a IndexField collection 
a class to hold IndexField objects 
a class to hold Index objects 

A NestedField collection 
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Nested FieldEnumerator 

Nested FieldHolder 

ReferencedSchema 

ReferencedSchemaCollection 

ReferencedSchemaEnumerator 

ReferencedSchemaHolder 

RelatedValue 

RelatedValueCollection 

RelatedValueEnumerator 

RelatedValueHolder 

Relationship 

RelationshipCollection 

RelationshipE numerator 

RelationshipHolder 

Schema 

Type 

View 

ViewCollection 

ViewEnumerator 

ViewField 

ViewFieldCollection 
ViewFieldEnumerator 
ViewFieldHolder 
ViewHolder 



A class for enumerating a NestedField collection 
a class to hold NestedField objects 

A ReferencedSchema collection 

A class for enumerating a ReferencedSchema collection 
a class to hold ReferencedSchema objects 

A RelatedValue collection 

A class for enumerating a RelatedValue collection 
a class to hold RelatedValue objects 

A Relationship collection 

A class for enumerating a Relationship collection 
a class to hold Relationship objects 



A View collection 

A class for enumerating a View collection 
A ViewField collection 

A class for enumerating a ViewField collection 
a class to hold ViewField objects 
a class to hold View objects 



Interfaces 



[0163] 

IBuiltlnFieldCollection 

IBuiltln FieldEnumerator 

IFieldCollection 

IFieldEnumerator 

MndexCollection 

NndexEnumerator 

HndexFieldCollection 

NndexFieldEnumerator 

INestedFieldCollection 

INestedFieldEnumerator 

I ReferencedSchemaCollection 

I ReferencedSchemaEnumerator 

I RelatedValueCollection 

I RelatedValueEnumerator 

I RelationshipCollection 

IRelationshipEnumerator 

IViewCollection 

IViewEnumerator 

I ViewFieldCollection 

I ViewFieldEnumerator 



An interface representing a BuiltlnField collection 

interface representing a class for enumerating a BuiltlnField collection 

An interface representing a Field collection 

interface representing a class for enumerating a Field collection 

An interface representing a Index collection 

interface representing a class for enumerating a Index collection 

An interface representing a IndexField collection 

interface representing a class for enumerating a IndexField collection 

An interface representing a NestedField collection 

interface representing a class for enumerating a NestedField collection 

An interface representing a ReferencedSchema collection 

interface representing a class for enumerating a ReferencedSchema collection 

An interface representing a RelatedValueCollection 

interface representing a class for enumerating a RelatedValue collection 

An interface representing a Relationship collection 

interface representing a class for enumerating a Relationship collection 

An interface representing a View collection 

interface representing a class for enumerating a View collection 

An interface representing a ViewField collection 

interface representing a class for enumerating a ViewField collection 



System.Sto raae.Meta.lnterop 

[0164] The following table lists examples of members exposed by the System.Storage.Meta.lnterop namespace. 
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Interfaces 



[0165] 

IBuiltlnField 

IBuiltlnType 

lEIementType 

I Field 

llndex 

MndexField 

INestedField 

I ReferencedSchema 

IRelatedValue 

I Relationship 

ISchema 

IType 

I View 

IViewField 



System.Storage.NaturalUI 

[0166] The following table lists examples of members exposed by the System.Storage.NaturalUI namespace. 



Classes 



[0167] 

Annotation Links the interpretations to annotations. It is used to decorate the interpretation with both State 

and Phrase annotations. 

AnnotationType Enumeration of different annotation types supported. Following are the valid set of Annotation 
types: 1 . Best Bet Exact 2. BestBetpartial 3. BiasedDown 4. BiasedUp 5. GeneratedBy 6. Required 
"Required" annotation type will implemented as a bias and biasedUp and biasedDown will also be 
implemented using biasedBy with positive/negative weights identifying each. 

Cluster A cluster is a grouping of locale and An notation Set. An AnnotationSet is a "partition" or application 

specific "string" that may be used to group logical data together and then selectively search over 
it. The concept of AnnotationSet followins from the NUIPEdit tool file format and it is the "basic 
unit of work". That is, the install process will work per AnnotationSet basis. 

Culture This is added to to support the internationalization feature. This entity serves dual purpose - along 

with storing all the languages supported by the Runtime Store, it also gives a mapping to the 
collations for each language which are used at runtime for matching query strings to phrase an- 
notations based on rules such as accent or case sensitivity etc.. 

NamedEntity Named Entities are strongly typed entities like email, url, datetime etc that are recognized by LSP. 

We need to store the fully qualified name of the named entity type that the NUI Runtime as well 
as LSP recognizes. 

Phrase Phrases that are used to annotate proxy and proxy classes (basically interpretations). This is what 

we call the phrase annotations. 
Phrase Word Stores the association of words to phrases that constitute that phrase. 

Serial izedObject From a Store stand point, the applications should be able to store any object and annotate it. The 
store needs to be as generic as possible. We don't have a hard requirement to recognize the 
structure of that data that is persisted. Therefore, we binary serialize the object or type instance 
and store it in a VARBINARY column. 

State Rule The state annotations are basically State Rule expressions that are authored by the NUI Authoring 

team. State rules will be created by developers as objects and stored in dlls. Along with Phrase, 
the fragments can be decorated with state annotations. 

Type The CLR type of the object instance persisted. This table holds both the Outer as well as the Inner 

type names. 

Word This represents the words in a Phrase. Words are shared across Phrases and hence are stored 

uniquely. A word is stored as a string along with the CHECKSUM value of the string. And for fast 
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retrievals, it is this checksum that is indexed instead of the actual string. 
System-Storage. NaturalU I .Interop 

[0168] The following table lists examples of members exposed by the System.Storage.NaturalUl.lnterop namespace. 
Interfaces 
[0169] 
I An notation 



Links the interpretations to annotations. It is used to decorate the interpretation with both State 
and Phrase annotations. 

Enumeration of different annotation types supported. Following are the valid set of Annotation 
types: 1 . BestBetExact 2. BestBetpartial 3. BiasedDown 4. BiasedUp 5. GeneratedBy 6. Required 
"Required" annotation type will implemented as a bias and biasedUp and biasedDown will also 
be implemented using biasedBy with positive/negative weights identifying each. 
A cluster is a grouping of locale and AnnotationSet. An AnnotationSet is a "partition" or application 
specific "string" that may be used to group logical data together and then selectively search over 
it. The concept of AnnotationSet followins from the NUIPEdit tool file format and it is the "basic 
unit of work". That is, the install process will work per AnnotationSet basis. 
This is added to to support the internationalization feature. This entity serves dual purpose - along 
with storing all the languages supported by the Runtime Store, it also gives a mapping to the 
collations for each language which are used at runtime for matching query strings to phrase an- 
notations based on rules such as accent or case sensitivity etc.. 

Named Entities are strongly typed entities like email, url, datetime etc that are recognized by LSP. 
We need to store the fully qualified name of the named entity type that the NUI Runtime as well 
as LSP recognizes. 

Phrases that are used to annotate proxy and proxy classes (basically interpretations). This is what 
we call the phrase annotations. 

Stores the association of words to phrases that constitute that phrase. 

From a Store stand point, the applications should be able to store any object and annotate it. The 
store needs to be as generic as possible. We don't have a hard requirement to recognize the 
structure of that data that is persisted. Therefore, we binary serialize the object or type instance 
and store it in a VARBINARY column. 

The state annotations are basically State Rule expressions that are authored by the NUI Authoring 
team. State rules will be created by developers as objects and stored in dlls. Along with Phrase, 
the fragments can be decorated with state annotations. 

The CLR type of the object instance persisted. This table holds both the Outer as well as the Inner 
type names. 

This represents the words in a Phrase. Words are shared across Phrases and hence are stored 
uniquely. A word is stored as a string along with the CHECKSUM value of the string. And for fast 
retrievals, it is this checksum that is indexed instead of the actual string. 

System-Storage. Notes 

[0170] The following table lists examples of members exposed by the System. Storage. Notes namespace. 



lAnnotationType 



ICIuster 



ICulture 



INamedEntity 

I Phrase 

IPhraseWord 
ISerializedQbject 

IStateRule 

IType 
IWord 



Classes 




[0171] 




ImageTitle 


An image title for an item. 


JournalNote 


A Windows Journal document. 


Note 


A base class for Notes. 


StickyNote 


A Sticky Note. 
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S y ste m . Sto rag e . N otes . I n te ro p 

[0172] The following table lists examples of members exposed by the System. Storage. Notes. I nterop namespace. 
Interfaces 



[0173] 

An image title for an item. 
A Windows Journal document. 
A base class for Notes. 
A Sticky Note. 



llmageTitle 
IJournalNote 
I Note 

IStickyNote 



Svstem.Storaqe.Notification 



[0174] The following table lists examples of members exposed by the System. Storage. Notification namespace. 



Classes 



Subscription 

System.Storage.Principal 

[0175] The following tables list examples of members exposed by the System.Storage.Principal namespace. 



Classes 



[0176] 



AccountCredentials 

AccountCredentialsCollection 

AccountCredentialsEnumerator 

AccountCredentialsHolder 

Accountlnformation 

AccountlnformationCollection 

Accountlnformation Enumerator 

Accountlnformation Holder 

Certificate 



CertificateCollection 

CertificateE numerator 

Certificate Holder 

CreditCardldentity 

CreditCardldentityClaim 

Emailldentity 

EmailldentityClaim 

Guidldentity 

GuidldentityClaim 

IdentityClaim 



IdentityClaimCollection 

IdentityClaim Enumerator 

IdentityClaimHolder 

Identity Reference 

Identity ReferenceCol lection 

Identity ReferenceEnumerator 



Describes the account information related to user/device accounts. 
A AccountCredentials collection 

A class for enumerating a AccountCredentials collection 
a class to hold AccountCredentials objects 
This type holds the fields for user account credentials. 
A Accountlnformation collection 

A class for enumerating a Accountlnformation collection 
a class to hold Accountlnformation objects 

This type defines scheme attributes for storing a digital certificate, a X.509 cer- 
tificate for instance. 
A Certificate collection 

A class for enumerating a Certificate collection 
a class to hold Certificate objects 
An Identity Reference holding credit card information. 
An IdentityClaim holding credit card information. 
An IdentityReference containing an email address. 
An IdentityClaim containing an email address. 

An IdentityClaim containing a GUID. 

An IdentityClaim is a value assigned by an authority of a given type to identify 
a single principal during a given period of time. Examples of IdentityClaims in- 
clude RFC 822 e-mail addresses, E.1 64 telephone numbers, Microsoft security 
identifiers (SIDs), and LDAP GUIDs. 
A IdentityClaim collection 

A class for enumerating a IdentityClaim collection 
a class to hold IdentityClaim objects 
An IdentityReference is a reference to an IdentityClaim. 
A IdentityReference collection 

A class for enumerating a IdentityReference collection 
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Identity ReferenceHolder 
LdapDN Identity 
LdapDNIdentityClaim 
L eg acyNT4 Parameters 



L eg acy NT4 P a ram ete recollection 

Legacy NT4 Parameters Enumerator 

LegacyNT4ParametersH older 

Licenseldentity 

LicenseldentityClaim 

NonScalarStringl 024 

NonScalarStringl 024Collection 

NonScalarStringl 024 Enumerator 

NonScalarStringl 024Holder 

NT4Accountld entity 

NT4AccountldentityClaim 

P2Pldentity 

P2PldentityClaim 

Principal 

PrincipalCollection 
PrincipalEnumerator 
PrincipalHolder 
PrincipalldentityKey 

PrincipalldentityKeyCollection 

PrincipalldentityKey Enumerator 

PrincipalldentityKeyHolder 

Security Identity 

Security IdentityClaim 

ServiceDelegationlnfo 

ServiceDelegationlnfoCollection 

ServiceDelegationlnfoEnumerator 

ServiceDelegationlnfoHolder 

SignedNestedElement 

SignedNestedElementCollection 

SignedNestedElementEnumerator 

SignedNestedElementHolder 

Ssnldentity 

SsnldentityClaim 

Transitldentity 

TransitldentityClaim 

Unknown Identity 

Unknown IdentityClaim 

Upnldentity 

UpnldentityClaim 

Interfaces 

[0177] 

lAccountCredentialsCollection 
lAccountCredentialsEnumerator 
lAccountlnformationCollection 
lAccountlnformation Enumerator 
ICertificateCollection 



a class to hold Identity Reference objects 

An IdentityReference containing an LDAP Distinguished Name. 

An IdentityClaim containing an LPAP Distinguished Name. 

Things not relevant to "WinFS" Systems. AD has a number of parameters that 

they do not think are not used. However, they are not sure about what appcom- 

pat issues will ensue if they remove them completely; hence, they are hiding 

them under LegacyNTParameters. 

A LegacyNT4Parameters collection 

A class for enumerating a LegacyNT4Parameters collection 

a class to hold Leg acy NT4 Parameters objects 

An IdentityReference containing license information. 

An IdentityClaim containing license information. 

A NonScalarStringl 024 collection 

A class for enumerating a NonScalarStringl 024 collection 
a class to hold NonScalarStringl 024 objects 



An IdentityReference containing P2P information. 
An IdentityClaim containing P2P information. 

A Principal is a security principal. It can authenticate its identity, access resourc- 
es, etc. 

A Principal collection 

A class for enumerating a Principal collection 
a class to hold Principal objects 

This type is derived from Identity Key to provide support for signatures and time 
based identities keys (driver's licence, temporary accounts etc.). 
A PrincipalldentityKey collection 

A class for enumerating a PrincipalldentityKey collection 
a class to hold PrincipalldentityKey objects 
Securityldentity Class 
SecurityldentityClaim Class 

A ServiceDelegationlnfo collection 

A class for enumerating a ServiceDelegationlnfo collection 
a class to hold ServiceDelegationlnfo objects 

A SignedNestedElement collection 

A class for enumerating a SignedNestedElement collection 

a class to hold SignedNestedElement objects 

An IdentityReference containing a Social Security Number. 

An IdentityClaim containing a Social Security Number. 

An IdentityReference containing routing information for a bank. 

An IdentityClaim containing routing information for a bank. 

An unknown IdentityReference. 

An unknown IdentityReference. 

An IdentityReference that contains a UPN. 

An IdentityClaim that contains a UPN. 



An interface representing a AccountCredentials collection 

interface representing a class for enumerating a AccountCredentials collection 

An interface representing a Accountlnformation collection 

interface representing a class for enumerating a Accountlnformation collection 

An interface representing a Certificate collection 
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I Certificate Enumerator 

MdentityClaimCollection 

MdentityClaimEnumerator 

I Identity ReferenceCollection 

I Identity ReferenceEnumerator 

ILegacyNT4ParametersCollection 

I Legacy NT4Parameters Enumerator 

INonScalarStringl 024Collection 
INonScalarStringl 024Enumerator 

IPrincipalCollection 

I Principal Enumerator 

I Principal IdentityKeyCollection 

I Principal IdentityKey Enumerator 

IServiceDelegationlnfoCollection 

IServiceDelegation Info Enumerator 

ISignedNestedElementCollection 
ISignedNestedElementEnumerator 



interface representing a class for enumerating a Certificate collection 
An interface representing a IdentityClaim collection 
interface representing a class for enumerating a IdentityClaim collection 
An interface representing a Identity Reference collection 
interface representing a class for enumerating a Identity Reference collection 
An interface representing a LegacyNT4Parameters collection 
interface representing a class for enumerating a LegacyNT4Parameters col- 
lection 

An interface representing a NonScalarStringl 024 collection 
interface representing a class for enumerating a NonScalarStringl 024 collec- 
tion 

An interface representing a Principal collection 
interface representing a class for enumerating a Principal collection 
An interface representing a PrincipalldentityKey collection 
interface representing a class for enumerating a PrincipalldentityKey collection 
An interface representing a ServiceDelegationlnfo collection 
interface representing a class for enumerating a ServiceDelegationlnfo collec- 
tion 

An interface representing a SignedNestedElement collection 
interface representing a class for enumerating a SignedNestedElement collec- 
tion 



Enumerations 



[0178] 



Password Modify Met hod WellKnownSidType This enumeration contains all of the well known SID types. 
System.Storage.Principal.lnteroE 

[0179] The following table lists examples of members exposed by the System. Storage. Principal. Interop namespace. 
Interfaces 



[0180] 



lAccountCredentials 
lAccountlnformation 
I Certificate 



NdentityClaim 



I Identity Reference 

I Legacy NT4Parameters 



INonScalarStringl 024 
IPrincipal 

IPrincipalldentityKey 



Describes the account information related to user/device accounts. 
This type holds the fields for user account credentials. 

This type defines scheme attributes for storing a digital certificate, a X.509 certificate for 
instance. 

An IdentityClaim is a value assigned by an authority of a given type to identify a single 
principal during a given period of time. Examples of IdentityClaims include RFC 822 e-mail 
addresses, E.164 telephone numbers, Microsoft security identifiers (SIDs), and LDAP 
GUIDs. 

An Id entity Reference is a reference to an IdentityClaim. 

Things not relevant to "WinFS" Systems. AD has a number of parameters that they do not 
think are not used. However, they are not sure about what appcompat issues will ensue if 
they remove them completely; hence, they are hiding them under Legacy NTParameters. 

A Principal is a security principal. It can authenticate its identity, access resources, etc. 
This type is derived from Identity Key to provide support for signatures and time based 
identities keys (driver's licence, temporary accounts etc.). 



IServiceDelegation Info 
ISignedNestedElement 
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Sy ste m . Sto rag e . P ro g ra ms 

[0181] The following table lists examples of members exposed by the System. Sto rage. Programs namespace. 
5 Classes 
[0182] 

Program 

10 

System. Storage. Programs. Interop 

[0183] The following table lists examples of members exposed by the System. Storage. Programs. Interop namespace. 

15 Interfaces 

[0184] 

I Program 
20 ^ 

Svstem.Storaae.Service 

[0185] The following table lists examples of members exposed by the System. Storage. Service namespace. 
25 Classes 
[0186] 

AuthenticationService 
30 EndPoint 



35 



40 EndPointCollection 
EndPointE numerator 
EndPointHolder 
IntElement 

45 IntElementCollection 

IntElement Enumerator 

IntElementHolder 

LocalizedDescription 

LocalizedDescriptionCollection 
50 LocalizedDescriptionEnumerator 

LocalizedDescriptionHolder 

LocalizedName 

LocalizedNameCollection 

LocalizedNameEnumerator 
55 LocalizedNameHolder 

Service 



Holds the attributes for AuthenticationService in the system. 
Each service can expose a number of service locations. These locations represent 
an association between the points of access for interacting with the service and 
the model or interface for manipulating the services available at that location. This 
class is consistent in nature with UPPI bindings and WSPL ports. The ELocation 
class currently exposed in the "WinFS" data model could potentially be useful in 
supporting this concept. The use of category and property information on this class 
will be considered secondary for the purposes of service location. This class will 
need to expose an overview document. This class will need to enforce referential 
integrity constraints between Binding,TechnicalModels andTechnicalModel.Tech- 
nicalModelKey 
A EndPoint collection 

A class for enumerating a EndPoint collection 
a class to hold EndPoint objects 

A wrapper to support multi-valued ints. Used in the AuthenticationService defini- 
tion. 

A IntElement collection 

A class for enumerating a IntElement collection 
a class to hold IntElement objects 
Holds language-specific descriptions of an entity. 
A LocalizedPescription collection 

A class for enumerating a LocalizedPescription collection 
a class to hold LocalizedPescription objects 
Holds language-specific names of an entity. 
A LocalizedName collection 

A class for enumerating a LocalizedName collection 
a class to hold LocalizedName objects 

Services are independent resources that can be manipulated through an electron- 
ic interface available at an identifiable location or address. Examples include web 
services and printing services. 
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ServiceProviderRelationship 
ServiceProviderRelationshipColle ction 

SyncService Sync item stores the sync profile information. For example, suppose we want to 

represent the AD service that sync's contact information. This would be represent- 
5 ed as: Category = "Active Directory" Name = "redmond" (name of the forest/do- 

main in which the contact resides) Last Sync ; Last Sync Error, other sync-related 
parameters. Property Set = list of AD/"WinFS" properties to be sync'ed. An exam- 
ple of a property set might be phone number and office location, i.e., the schema 
designer can specify a partial sync ratherthan sync'ing down all the AD properties. 

10 

Interfaces 
[0187] 

15 lEndPointCollection 

lEndPointEnumerator 

NntElementCollection 

NntElementEnumerator 

ILocalizedDescriptionCollection 
20 ILocalizedDescription Enumerator 

ILocalizedNameCollection 

ILocalizedNameEnumerator 

Sy ste m . Sto rag e . Se r v ice . I n tero p 

25 

[0188] The following table lists examples of members exposed by the System. Storage. Service. I nterop namespace. 
Interfaces 
30 [0189] 

lAuthenticationService Holds the attributes for AuthenticationService in the system. 

lEndPoint Each service can expose a number of service locations. These locations represent an as- 

sociation between the points of access for interacting with the service and the model or 
35 interface for manipulating the services available at that location. This class is consistent in 

nature with UDDI bindings and WSDL ports. The ELocation class currently exposed in the 
"WinFS" data model could potentially be useful in supporting this concept. The use of cate- 
gory and property information on this class will be considered secondary for the purposes 
of service location. This class will need to expose an overview document. This class will 
40 need to enforce referential integrity constraints between Binding,TechnicalModels and Tech- 

nical Model. Technical Model Key 

MntElement A wrapper to support multi-valued ints. Used in the AuthenticationService definition. 

ILocalizedDescription Holds language-specific descriptions of an entity. 

ILocalizedName Holds language-specific names of an entity. 

45 IService Services are independent resources that can be manipulated through an electronic interface 

available at an identifiable location or address. Examples include web services and printing 
services. 

ISyncService Sync item stores the sync profile information. For example, suppose we want to represent 

the AD service that sync's contact information. This would be represented as: Category = 
50 "Active Directory" Name = "redmond" (name of the forest/domain in which the contact re- 

sides) Last Sync, Last Sync Error, other sync-related parameters. Property Set = list of 
AD/"WinFS" properties to be sync'ed. An example of a property set might be phone number 
and office location, i.e., the schema designer can specify a partial sync rather than sync'ing 
down all the AD properties. 

55 

System .Sto rage .She I ITask 

[0190] The following tables list examples of members exposed by the System. Sto rage. Sh el ITask namespace. 



An interface representing a EndPoint collection 

interface representing a class for enumerating a EndPoint collection 

An interface representing a IntElement collection 

interface representing a class for enumerating a IntElement collection 

An interface representing a LocalizedDescription collection 

interface representing a class for enumerating a LocalizedDescription collection 

An interface representing a LocalizedName collection 

interface representing a class for enumerating a LocalizedName collection 
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Classes 



[0191] 



Appl 



Appl 



Appl 



Appl 



Appl 



A££l 



cation 



The top-level owner of Tasks and Implementations. 



cation ExperienceRelationship 



cation ExperienceRelationshipCollection 



cation Implementation Relationship 



cation I mplementationRelationshipCollection 



cation Man if estRelationship 



cationManifestRelationshipCollection 



cationTaskRelationship 



cationTaskRelationshipCollection 



AttachmentsRelationship 

AttachmentsRelationshipCollection 

AutomatedTask 

Category 

EntryPoint 

Entry PointCollection 

Entry PointEnumerator 

EntryPointHolder 

Experience 



ExperienceScopeLinkRelationship 
ExperienceScopeLinkRelationshipCollection 
ExtendsExperienceLinkRelationship 
Extends ExperienceLinkRelationshipCollection 
Implementation 

QrderedLink 
QrderedLinkCollection 
QrderedLinkEnumerator 
OrderedLinkHolder 



Scope 



ScopeLink 

ScopeLinkCollection 

ScopeLinkE numerator 

ScopeLinkHolder 

ScopeTaskLinkRelationship 

ScopeTaskLinkRelationshipCollection 

ShellTaskRelationship 

ShellTaskRelationshipCollection 

SubjectTerm 

Task 



TaskCategoryList 

Tas kC ateg o ry L i stC o 1 1 ecti o n 

TaskCategoryList Enumerator 

TaskCategoryListHolder 



An AutomatedTask is a task that does not involve human inter- 
vention such as printing a document. 

Categories are a user-browsable taxonomy containing Tasks. 
Defines a way to launch code or browse to a page. 
A EntryPoint collection 

A class for enumerating a EntryPoint collection 
a class to hold EntryPoint objects 

Experience describes the folder being browsed, file type selected, 
or other user experience during which aTask might appear. ATask 
is mapped to an Experience through a Scope. Examples of expe- 
rience might be: 'ShellTask. InMyDocumentsFolder', 'ShellTask. 
ImageFilesSelected 1 , 'ShellTask. StartPage 1 , etc. 



An entry point which can be launched as a result of a Task being 
clicked. 

Use this type to link items in a particular order. 
A OrderedLink collection 

A class for enumerating a OrderedLink collection 
a class to hold OrderedLink objects 

Scope defines in what Presentation a Task should appear during 
a certain Experience. A Task is mapped to an Experience through 
a Scope. Examples of Scopes might be: 'The Task Pane in the 
MyDocuments folder', 'The Context menu when an Image file is 
selected', etc. 

Used to link Scopes to an Experience. 
A ScopeLink collection 

A class for enumerating a ScopeLink collection 
a class to hold ScopeLink objects 



SubjectTerms are used as a user-browsable Index for Tasks. 
A Shell Task is a representation of something the system can do 
such as print a document, send a message or reconfigure the 
desktop. 

A TaskCategoryList collection 

A class for enumerating a TaskCategoryList collection 
a class to hold TaskCategoryList objects 
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TaskCategoryTop Implementation List 
TaskCategoryToplmplementationListCollection 
TaskCategoryTop Implementation List Enumerator 

TaskCategoryToplmplementationListHolder 

TasklmplementationLinkRelationship 

TasklmplementationLinkRelationshipCollection 

Tas k I mp lem entati o n List 

TasklmplementationListCol lection 

TasklmplementationListEnumerator 

TasklmplementationListHolder 

TaskScopelmplementationList 

TaskScopelmplementationListCollection 

TaskScopelmplementationListEnumerator 

TaskScopelmplementationListHolder 

TaskScopeList 

TaskScopeListCollection 

Tas kScopeList E n u m erato r 

TaskScopeListHolder 

TaskStateLinkRelationship 

TaskStateLinkRelationshipCollection 

TaskToplmplementationList 

TaskToplmplementationListCollection 

TaskToplmplementationListEnumerator 

TaskToplmplementationListHolder 

WindowsUser 

WindowsUserCollection 

WindowsUserEnumerator 

WindowsUserHolder 



A TaskCategoryTop ImplementationList collection 

A class for enumerating a TaskCategoryTop Implementation List 

collection 

a class to hold TaskCategoryTop Implementation List objects 



A TasklmplementationList collection 

A class for enumerating a TasklmplementationList collection 
a class to hold TasklmplementationList objects 

A TaskScopelmplementationList collection 
A class for enumerating a TaskScopelmplementationList collec- 
tion 

a class to hold TaskScopelmplementationList objects 
A TaskScopeList collection 

A class for enumerating a TaskScopeList collection 
a class to hold TaskScopeList objects 



A TaskToplmplementationList collection 

A class for enumerating a TaskToplmplementationList collection 

a class to hold TaskToplmplementationList objects 

A windows user. 

A WindowsUser collection 

A class for enumerating a WindowsUser collection 
a class to hold WindowsUser objects 



Interfaces 



[0192] 

lEntryPointCollection 

lEntryPointEnumerator 

IQrderedLinkCollection 

IQrderedLinkEnumerator 

IScopeLinkCollection 

IScopeLinkEnumerator 

ITaskCategoryListCollection 

ITaskCategory List Enumerator 

ITaskCategoryToplmplementationLi 
stCollection 

ITaskCategory ToplmplementationLi 
stEnumerator 

ITasklmplementationListCollection 
ITasklmplementationListEnumerator 

ITaskScopelmplementationListColle ction 
ITaskScopelmplementationListEnum erator 

ITaskScopeListCollection 
ITaskScopeListEnumerator 

ITaskToplmplementationListCollecti on 



An interface representing a EntryPoint collection 
interface representing a class for enumerating a EntryPoint collection 
An interface representing a OrderedLink collection 
interface representing a class for enumerating a OrderedLink collection 
An interface representing a ScopeLink collection 
interface representing a class for enumerating a ScopeLink collection 
An interface representing a Tas kCategory List collection 
interface representing a class for enumerating a TaskCategoryList col- 
lection 

An interface representing a 
TaskCategoryToplmplementationLis t collection 
interface representing a class for 

enumerating a TaskCategoryTop Implementation Lis t collection 
An interface representing a TasklmplementationList collection 
interface representing a class for enumerating a Tasklmplementation- 
List collection 

An interface representing a TaskScopelmplementationList collection 
interface representing a class for enumerating a TaskScopelmplemen- 
tationList collection 

An interface representing a TaskScopeList collection 
interface representing a class for enumerating a TaskScopeList collec- 
tion 

An interface representing a TaskToplmplementationList collection 
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ITaskToplmplementationListEnumer ator interface representing a class for enumerating a TaskToplmplementa- 

tionList collection 

IWindowsUserCollection An interface representing a WindowsUser collection 

IWindowsUserEnumerator interface representing a class for enumerating a WindowsUser collec- 

tion 



System.Storage.ShellTask.lnterop 

[0193] The following table lists examples of members exposed by the System. Storage. ShellTask. I nterop namespace. 



Interfaces 



[0194] 

lApplication The top-level owner of Tasks and Implementations. 

lAutomatedTask An AutomatedTask is a task that does not involve human intervention such as printing a document. 
ICategory Categories are a user-browsable taxonomy containing Tasks. 

lEntryPoint Defines a way to launch code or browse to a page. 

lExperience Experience describes the folder being browsed, file type selected, or other user experience during 

which a Task might appear. A Task is mapped to an Experience through a Scope. Examples of 
experience might be: 



'ShellTask. I nMyDocumentsFolder', 
'ShellTask. I mageFilesSelected', 
'ShellTask.StartPage', etc. 



[Implementation 

IQrderedLink 

IScope 



IScopeLink 

ISubjectTerm 

ITask 



An entry point which can be launched as a result of a Task being clicked. 
Use this type to link items in a particular order. 

Scope defines in what Presentation a Task should appear during a certain Experience. A Task is 
mapped to an Experience through a Scope. Examples of Scopes might be: 'The Task Pane in the 
MyDocuments folder', 'The Context menu when an Image file is selected', etc. 
Used to link Scopes to an Experience. 

SubjectTerms are used as a user-browsable Index for Tasks. 

A Shell Task is a representation of something the system can do such as print a document, send 
a message or reconfigure the desktop. 



ITaskCategoryList 

ITaskCategoryToplmplementationList 

ITasklmplementationList 

ITaskScopelmplementationList 

ITaskScopeList 

ITaskToplmplementationList 

IWindowsUser A windows user. 



System.Storaqe.Synchronization 

[0195] The following tables list examples of members exposed by the System . Storage. Synchronization namespace. 



Classes 



[0196] 



AcknowledgeChanges 

AdapterAttribute 

AdapterConfigHandler 

AdapterFactoryTypeAttribute 

Adapterlnstaller 

AdapterKnowledgeManager 

AdvertiseChanges 
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Awareness 

CancellableQbject 

Change 

ChangeAcknowledgement 

ChangeAcknowledgementWriter 

ChangeApplier 

ChangeMetaData 

ChangeReader 

ChangeRetriever 

Changes 

ChangeStatus 

ChangeWriter 

ConfigurationTypeAttribute 

Conflict 

ConflictDictionary 

ConflictHandler 

ConflictHandlerContext 

ConflictHandlerList 

ConflictHandlerTypesHelper 

ConflictHandlingSession 

Conflict Information 

ConflictLog 

ConflictManager 

ConflictRecord 

ConflictRecordCollection 

ConflictResult 

ConflictResultlnformation 

ConveyChanges 

DefaultChangeApplier 

DefaultChangeApplierBase 

DefaultChangeApplierConfiguration 

DefaultChangeRetriever 

DefaultChangeRetrieverBase 

DefaultChangeRetrieverConfiguration 

DefaultConflictFilter 

DefaultConflictResolver 

DeleteUpdateConflict 

Empty ProfileConfigurationException 

EndpointAccess Exception 

EndPointFormatAttribute 

FolderNotFound Exception 

GetltemAwarenessResult 

HashEntry 

InsertlnsertConflict 

InvalidSynchronizationProfileException 
ItemAwarenesslndexElement 
ItemAwarenessProperties 
Knowledge 

KnowledgeScopelncludeAttribute 
ListHash Enumerator 
ListHashtable 

LocalChangeAcknowledgementWriter 
LocalEndpoint 

Local KnowledgeFormatAttribute 
LoggedConflictResult 
Mapping Not Found Exception 
NativeMethods 
OutOfSyncException 



PartnerAwareness 
ProgressValue 
Projectlnstaller 
Query 

RejectedConflictResult 
RemoteAdapter Factory 

RemoteChangeApplierConfigu ration Attribute 

RemQteChangeRetrieverConfiguratiQn Attribute 

RemoteData 

RequestChanges 

ResolvedConflictResult 

ResponseFault 

Scope 

StateChangeEventArgs 

StoredKnowledgeChangeReader 

StoredKnowledgeChangeWriter 

SuppliedKnowledgeChangeReader 

SuppliedKnowledgeChangeWriter 

Synchronization Adapter 

SynchronizationCancelledException 

Synchronization Events 

Synchronization Profile 

Synchronization Request 

Synchronization Runtimelnstaller 

SynchronizationSession 

SynchronizeCompletedEventArgs 

SynchronizeProgressChangedEventArgs 

UnableToDeserializeProfileException 

UnhandledConflictException 

UpdateDeleteConflict 

UpdateUpdateConflict 

Version 

WinfsAdapterConfiguration 

Win FSChangeApplier 

Win FSChangeRetriever 

WinfsRemoteEndpoint 

Win FSSyncDcomClass 

WinFSSyncDcomClientClass 

Win FSSyncDcomServerClass 

WinfsSyncException 

WinfsSynchronization Adapter 

WinfsSynchronizationAdapterFactory 

WinfsSynchronization Adapterlnstaller 

WinfsSynchronization Mapping 

WinfsSynchronization MappingManager 

WinfsSyncTransportException 

WSSyncMessage 

Interfaces 

[0197] 

lAdapterFactory 
ICancellable 

ISynchronizationEventsCallback 
ISynchronizationRequest 
IWinFSSyncDcomClient 
IWinFSSyncDcomListener 
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IWinFSSyncDcomServer 
WinFSSyncDcom 
WinFSSyncDcomClient 
Win FSSyncDcomServer 

5 

Enumerations 
[0198] 

10 AwarenessComparison Result 

Awareness Level Of Item 

ChangeResult 

Conflict Log Action 

ConflictResolutionType 
15 DefaultConflictResolverResolutionType 

ItemAwarenessType 

QueryFormat 

ReadState 

SessionState 
20 SyncChangeType 

SynchronizationState 

SynchronizationTypes 

WinfsAdapterConf iguration Flags 

WriteState 
25 WSSyncMessageType 

Structures 

[0199] 

30 

KnowledgeScopingld 

Delegates 

35 [0200] 

CancelHandler 
StateChangedEventHandler 
StateChangingEventHandler 
40 SynchronizeCompletedEventHandler 

SynchronizeProgressChangedEventHandler 
Synch ronizeStartedEventHandler 

System .Storage. Synchronization.lnterop 

45 * 

[0201] The following tables list examples of members exposed by the System. Storage. Synchronization.lnterop 
namespace. 

Classes 

50 

[0202] 

WinfsSynchronizationConf iguration 
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Interfaces 
[0203] 

IWinfsSynchronizationConfiguration 
System.Storaqe.Synchronization.Schedulinq 

[0204] The following tables list examples of members exposed by the System.Storage.Synchronization. Scheduling 
namespace. 

Classes 

[0205] 

DailyTrigger 

IdleTrigger 

IntervalTrigger 

LogonTrigger 

RunOnceTrigger 

SyncScheduler 

SystemStartTrigger 

Task 

TaskList 

TemporalTriqqer 

Trigger 

TriggerCollection 

Enumerations 

[0206] 

DaysOfTheWeek 

MonthsQfTheYear 

WeeksQfTTieMonth 

System.Storage.Synchronization.SyncHandler 

[0207] The following tables list examples of members exposed by the System. Storage. Synchronization. SyncHandler 
namespace. 

Classes 

[0208] 

Win FSSyncHandlerBase 
Enumerations 
[0209] 

ProfileType 
Svstem.Storaqe. UserTask 

[0210] The following table lists examples of members exposed by the System. Storage. UserTask namespace. 
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The Appointment type defines an event that happens for a limited period of time. 

The Event type defines an event that lasts over a period of time such as a user conference. 

The Meeting type defines a meeting event. 



Classes 

[0211] 

Appointment 
Event 
Meeting 
TaskApplicationRelationship 
TaskApplicationRelationshipCollection 
TaskCompanies Relationship 
TaskCompaniesRelationshipCollection 
TaskDelegatorRelationship 
TaskDelegatorRelationshipCollection 
TaskQwnerRelationship 
TaskQwnerRelationshipCollection 
TaskRecipientsRelationship 
TaskRecipientsRelationshipCollection 

TaskRequestAcceptltem The TaskRequestAcceptltem type defines behavior used when a task is used as a part 

of request for acceptance. 

The TaskRequestDeclineltem type defines behavior used when a task is used as a part 
of decline. 

TheTaskRequestltem type defines behavior used when a task is used as a part of request. 
The TaskRequestUpdateltem type defines behavior used when a task is used as a part 
of request for update. 

A UserTask is something that someone does. 



TaskRequestDeclineltem 

TaskRequestltem 
TaskRequestUpdateltem 



UserTask 
System-Storage. UserTask.lnterop 

[0212] The following table lists examples of members exposed by the System. Storage. UserTask. Interop namespace. 
Interfaces 



[0213] 

lAppointment 
I Event 

IMeeting 

ITaskRequestAcceptltem 
ITaskRequestDeclineltem 
ITaskRequestltem 
ITaskRequestUpdateltem 
I UserTask 



The Appointment type defines an event that happens for a limited period of time. 
The Event type defines an event that lasts over a period of time such as a user confer- 
ence. 

The Meeting type defines a meeting event. 

The TaskRequestAcceptltem type defines behavior used when a task is used as a part 
of request for acceptance. 

The TaskRequestDeclineltem type defines behavior used when a task is used as a part 
of decline. 

The TaskRequestltem type defines behavior used when a task is used as a part of re- 
quest. 

The TaskRequestUpdateltem type defines behavior used when a task is used as a part 
of request for update. 

A UserTask is something that someone does. 



System .Storage .Video 

[0214] The following tables list examples of members exposed by the System. Storage. Video namespace. 
Classes 



[0215] 

RecordedTV 
Video 



The type Video. Video represents a video recording. 
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VideoClip 

VideoClipCollection 
VideoClip Enumerator 
VideoClipHolder 



A VideoClip collection 

A class for enumerating a VideoClip collection 
a class to hold VideoClip objects 



Interfaces 



[0216] 

I VideoClipCollection An interface representing a VideoClip collection 

IVideoClipE numerator interface representing a class for enumerating a VideoClip collection 



System .Storage. Video.lnterop 

[0217] The following table lists examples of members exposed by the System. Storage. Video.lnterop namespace. 



Interfaces 



[0218] 

IRecordedTV 

IVideo The type Video. Video represents a video recording. 



IVideoClip 

System .Storage. Watcher 

[0219] The following tables list examples of members exposed by the System. Storage. Watcher namespace. 



Classes 



[0220] 



Folderltem Watcher a watcher to monitor item events under a folder 

FolderltemWatcherState a Folder watcher state 
ItemChangeDetail 
ItemChangeDetailCol lection 

ItemChangedEventArgs ItemChangedEventArgs 

Item Watcher watcher modified/removed events on an object 

StoreEventArgs EventArgs returned from "WinFS" Store 

WatcherState WatcherState 



Enumerations 



[0221] 

Folderltem Watch erOptions the options can be passed to ctors of FolderltemWatcher. The options can be added 

together byl 

ItemWatch erOptions options on ItemWatcher 



Watch erEventType 

Delegates 

[0222] 

ItemChangedEventHandler delegate for ItemChangedEvent in Watcher 
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OnStoreEventHandler 
System-Storage. Watcher.lnterop 
5 [0223] The following table lists examples of members exposed by the System. Storage. Watcher.lnterop namespace. 
Interfaces 
[0224] 

10 

IFolderltemWatcher 
I FolderltemWatcherState 
NtemChangeDetail 
NtemChangedEventData 
15 I Item Watcher 

IStoreEventData 
IWatcherEvent 

IWatcherState 

20 

EXAMPLE COMPUTING SYSTEM AND ENVIRONMENT 

[0225] Fig. 5 illustrates an example of a suitable computing environment 400 within which the programming frame- 
work 1 32 may be implemented (either fully or partially). The computing environment 400 may be utilized in the computer 

25 and network architectures described herein. 

[0226] The exemplary computing environment 400 is only one example of a computing environment and is not in- 
tended to suggest any limitation as to the scope of use or functionality of the computer and network architectures. 
Neither should the computing environment 400 be interpreted as having any dependency or requirement relating to 
any one or combination of components illustrated in the exemplary computing environment 400. 

30 [0227] The framework 1 32 may be implemented with numerous other general purpose or special purpose computing 
system environments or configurations. Examples of well known computing systems, environments, and/or configura- 
tions that may be suitable for use include, but are not limited to, personal computers, server computers, multiprocessor 
systems, microprocessor-based systems, network PCs, minicomputers, mainframe computers, distributed computing 
environments that incl ude any of the above systems or devices , and so on. Compact or subset versions of the framework 

35 may also be implemented in clients of limited resources, such as cellular phones, personal digital assistants, handheld 
computers, or other communication/computing devices. 

[0228] The framework 132 may be described in the general context of computer-executable instructions, such as 
program modules, being executed by one or more computers or other devices. Generally, program modules include 
routines, programs, objects, components, data structures, etc. that perform particular tasks or implement particular 
40 abstract data types. The framework 1 32 may also be practiced in distributed computing environments where tasks are 
performed by remote processing devices that are linked through a communications network. In a distributed computing 
environment, program modules may be located in both local and remote computer storage media including memory 
storage devices. 

[0229] The computing environment 400 includes a general-purpose computing device in the form of a computer 402. 
45 The components of computer 402 can include, by are not limited to, one or more processors or processing units 404, 
a system memory 406, and a system bus 408 that couples various system components including the processor 404 
to the system memory 406. 

[0230] The system bus 408 represents one or more of several possible types of bus structures, including a memory 
bus or memory controller, a peripheral bus, an accelerated graphics port and a processor or local bus using any of a 
50 variety of bus architectures. By way of example, such architectures can include an Industry Standard Architecture (ISA) 
bus, a Micro Channel Architecture (MCA) bus, an Enhanced ISA (EISA) bus, a Video Electronics Standards Association 
(VESA) local bus, and a Peripheral Component Interconnects (PCI) bus also known as a Mezzanine bus. 
[0231] Computer 402 typically includes a variety of computer readable media. Such media can be any available 
media that is accessible by computer 402 and includes both volatile and non-volatile media, removable and non- 
55 removable media. 

[0232] The system memory 406 includes computer readable media in the form of volatile memory, such as random 
access memory (RAM) 410, and/or non-volatile memory, such as read only memory (ROM) 412. A basic input/output 
system (BIOS) 414, containing the basic routines that help to transfer information between elements within computer 



a watcher to monitor item events under a folder 
a Folder watcher state 

ItemChangedEventArgs 

a watcher to monitor item modifiedVemoved events 
EventArgs returned from "WinFS" Store 

Implement this class in a COM app to receive events from an ItemWatcher or Folderltem- 

Watcher 

Watch erState 
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402, such as during start-up, is stored in ROM 412. RAM 410 typically contains data and/or program modules that are 
immediately accessible to and/or presently operated on by the processing unit 404. 

[0233] Computer 402 may also include other removable/non-removable, volatile/non-volatile computer storage me- 
dia. By way of example, Fig. 5 illustrates a hard disk drive 416 for reading from and writing to a non-removable, non- 

5 volatile magnetic media (not shown), a magnetic disk drive 41 8 for reading from and writing to a removable, non-volatile 
magnetic disk 420 (e.g., a "floppy disk"), and an optical disk drive 422 for reading from and/or writing to a removable, 
non-volatile optical disk 424 such as a CD-ROM, DVD-ROM, or other optical media. The hard disk drive 41 6, magnetic 
disk drive 418, and optical disk drive 422 are each connected to the system bus 408 by one or more data media 
interfaces 426. Alternatively, the hard disk drive 41 6, magnetic disk drive 41 8, and optical disk drive 422 can be con- 

10 nected to the system bus 408 by one or more interfaces (not shown). 

[0234] The disk drives and their associated computer-readable media provide non-volatile storage of computer read- 
able instructions, data structures, program modules, and other data for computer 402. Although the example illustrates 
a hard disk 41 6, a removable magnetic disk 420, and a removable optical disk 424, it is to be appreciated that other 
types of computer readable media which can store data that is accessible by a computer, such as magnetic cassettes 

15 or other magnetic storage devices, flash memory cards, CD-ROM, digital versatile disks (DVD) or other optical storage, 
random access memories (RAM), read only memories (ROM), electrically erasable programmable read-only memory 
(EEPROM), and the like, can also be utilized to implement the exemplary computing system and environment. 
[0235] Any number of program modules can be stored on the hard disk 416, magnetic disk 420, optical disk 424, 
ROM 412, and/or RAM 41 0, including by way of example, an operating system 426, one or more application programs 

20 428, other program modules 430, and program data 432. Each of the operating system 426, one or more application 
programs 428, other program modules 430, and program data 432 (or some combination thereof) may include elements 
of the programming framework 132. 

[0236] A user can enter commands and information into computer 402 via input devices such as a keyboard 434 
and a pointing device 436 (e.g., a "mouse"). Other input devices 438 (not shown specifically) may include a microphone, 

25 joystick, game pad, satellite dish, serial port, scanner, and/or the like. These and other input devices are connected to 
the processing unit 404 via input/output interfaces 440 that are coupled to the system bus 408, but may be connected 
by other interface and bus structures, such as a parallel port, game port, or a universal serial bus (USB). 
[0237] A monitor 442 or other type of display device can also be connected to the system bus 408 via an interface, 
such as a video adapter 444. In addition to the monitor 442, other output peripheral devices can include components 

30 such as speakers (not shown) and a printer 446 which can be connected to computer 402 via the input/output interfaces 
440. 

[0238] Computer 402 can operate in a networked environment using logical connections to one or more remote 
computers, such as a remote computing device 448. By way of example, the remote computing device 448 can be a 
personal computer, portable computer, a server, a router, a network computer, a peer device or other common network 
35 node, and so on. The remote computing device 448 is illustrated as a portable computer that can include many or all 
of the elements and features described herein relative to computer 402. 

[0239] Logical connections between computer 402 and the remote computer 448 are depicted as a local area network 
(LAN) 450 and a general wide area network (WAN) 452. Such networking environments are commonplace in offices, 
enterprise-wide computer networks, intranets, and the Internet. 

40 [0240] When implemented in a LAN networking environment, the computer 402 is connected to a local network 450 
via a network interface or adapter 454. When implemented in a WAN networking environment, the computer 402 
typically includes a modem 456 or other means for establishing communications over the wide network 452. The 
modem 456, which can be internal or external to computer 402, can be connected to the system bus 408 via the input/ 
output interfaces 440 or other appropriate mechanisms. It is to be appreciated that the illustrated network connections 

^5 are exemplary and that other means of establishing communication link(s) between the computers 402 and 448 can 
be employed. 

[0241] In a networked environment, such as that illustrated with computing environment 400, program modules de- 
picted relative to the computer 402, or portions thereof, may be stored in a remote memory storage device. By way of 
example, remote application programs 458 reside on a memory device of remote computer 448. For purposes of 
50 illustration, application programs and other executable program components such as the operating system are illus- 
trated herein as discrete blocks, although it is recognized that such programs and components reside at various times 
in different storage components of the computing device 402, and are executed by the data processor(s) of the com- 
puter. 

[0242] An implementation of the framework 132 and/or 150, and particularly, the API included in the framework 132 
55 and/or 150 or calls made to the API included in the framework 132 and/or 150, may be stored on or transmitted across 
some form of computer readable media. Computer readable media can be any available media that can be accessed 
by a computer. By way of example, and not limitation, computer readable media may comprise "computer storage 
media" and "communications media." "Computer storage media" include volatile and non-volatile, removable and non- 
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removable media implemented in any method or technology for storage of information such as computer readable 
instructions, data structures, program modules, or other data. Computer storage media includes, but is not limited to, 
RAM, ROM, EEPROM, flash memory or other memory technology, CD-ROM, digital versatile disks (DVD) or other 
optical storage, magnetic cassettes, magnetic tape, magnetic disk storage or other magnetic storage devices, or any 

5 other medium which can be used to store the desired information and which can be accessed by a computer. 

[0243] "Communication media" typically embodies computer readable instructions, data structures, program mod- 
ules, or other data in a modulated data signal, such as carrier wave or other transport mechanism. Communication 
media also includes any information delivery media. The term "modulated data signal" means a signal that has one or 
more of its characteristics set or changed in such a manner as to encode information in the signal. Byway of example, 

10 and not limitation, communication media includes wired media such as a wired network or direct-wired connection, 
and wireless media such as acoustic, RF, infrared, and other wireless media. Combinations of any of the above are 
also included within the scope of computer readable media. 

[0244] Alternatively, portions of the framework may be implemented in hardware or a combination of hardware, soft- 
ware, and/or firmware. For example, one or more application specific integrated circuits (ASICs) or programmable logic 

15 devices (PLDs) could be designed or programmed to implement one or more portions of the framework. 

[0245] A programming interface (or more simply, interface) may be viewed as any mechanism, process, protocol for 
enabling one or more segment(s) of code to communicate with or access the functionality provided by one or more 
other segment(s) of code. Alternatively, a programming interface may be viewed as one or more mechanism(s), method 
(s), function call(s), module(s), object(s), etc. of a component of a system capable of communicative coupling to one 

20 or more mechanism(s), method(s). function call(s), module(s), etc. of other component(s). The term "segment of code" 
in the preceding sentence is intended to include one or more instructions or lines of code, and includes, e.g., code 
modules, objects, subroutines, functions, and so on, regardless of the terminology applied or whether the code seg- 
ments are separately compiled, or whether the code segments are provided as source, intermediate, or object code, 
whether the code segments are utilized in a runtime system or process, or whether they are located on the same or 

25 different machines or distributed across multiple machines, or whether the functionality represented by the segments 
of code are implemented wholly in software, wholly in hardware, or a combination of hardware and software. 
[0246] Notionally, a programming interface may be viewed generically, as shown in Fig. 6 or Fig. 7. Fig. 6 illustrates 
an interface Interface 1 as a conduit through which first and second code segments communicate. Fig. 7 illustrates an 
interface as comprising interface objects 11 and 12 (which may or may not be part of the first and second code seg- 

30 ments), which enable first and second code segments of a system to communicate via medium M. In the view of Fig. 
7, one may consider interface objects 11 and 12 as separate interfaces of the same system and one may also consider 
that objects 11 and 12 plus medium M comprise the interface. Although Figs. 6 and 7 show bi-directional flow and 
interfaces on each side of the flow, certain implementations may only have information flow in one direction (or no 
information flow as described below) or may only have an interface object on one side. By way of example, and not 

35 limitation, terms such as application programming or program interface (API), entry point, method, function, subroutine, 
remote procedure call, and component object model (COM) interface, are encompassed within the definition of pro- 
gramming interface. 

[0247] Aspects of such a programming interface may include the method whereby the first code segment transmits 
information (where "information" is used in its broadest sense and includes data, commands, requests, etc.) to the 

40 second code segment; the method whereby the second code segment receives the information; and the structure, 
sequence, syntax, organization, schema, timing and content of the information. In this regard, the underlying transport 
medium itself may be unimportant to the operation of the interface, whether the medium be wired or wireless, or a 
combination of both, as long as the information is transported in the manner defined by the interface. In certain situa- 
tions, information may not be passed in one or both directions in the conventional sense, as the information transfer 

45 may be either via another mechanism (e.g. information placed in a buffer, file, etc. separate from information flow 
between the code segments) or non-existent, as when one code segment simply accesses functionality performed by 
a second code segment. Any or all of these aspects may be important in a given situation, e.g., depending on whether 
the code segments are part of a system in a loosely coupled or tightly coupled configuration, and so this list should be 
considered illustrative and non-limiting. 

so [0248] This notion of a programming interface is known to those skilled in the art and is clear from the foregoing 
detailed description of the invention. There are, however, other ways to implement a programming interface, and, 
unless expressly excluded, these too are intended to be encompassed by the claims set forth at the end of this spec- 
ification. Such other ways may appear to be more sophisticated or complex than the simplistic view of Figs. 6 and 7, 
but they nonetheless perform a similar function to accomplish the same overall result. We will now briefly describe 

55 some illustrative alternative implementations of a programming interface. 
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A. FACTORING 

[0249] A communication from one code segment to another may be accomplished indirectly by breaking the com- 
munication into multiple discrete communications. This is depicted schematically in Figs. 8 and 9. As shown, some 

5 interfaces can be described in terms of divisible sets of functionality. Thus, the interface functionality of Figs. 6 and 7 
may be factored to achieve the same result, just as one may mathematically provide 24, or 2 times 2 times 3 times 2. 
Accordingly, as illustrated in Fig. 8, the function provided by interface Interfacel may be subdivided to convert the 
communications of the interface into multiple interfaces InterfacelA, Interface 1B, Interface 1C, etc. while achieving 
the same result. As illustrated in Fig. 9, the function provided by interface 11 may be subdivided into multiple interfaces 

10 11 a, 11b, 11c, etc. while achieving the same result. Similarly, interface 12 of the second code segment which receives 
information from the first code segment may be factored into multiple interfaces I2a, I2b, I2c. etc. When factoring, the 
number of interfaces included with the 1 st code segment need not match the number of interfaces included with the 
2 nd code segment. In either of the cases of Figs. 8 and 9, the functional spirit of interfaces Interfacel and 11 remain 
the same as with Figs. 6 and 7, respectively. The factoring of interfaces may also follow associative, commutative, and 

15 other mathematical properties such that the factoring maybe difficult to recognize. For instance, ordering of operations 
may be unimportant, and consequently, a function carried out by an interface may be carried out well in advance of 
reaching the interface, by another piece of code or interface, or performed by a separate component of the system. 
Moreover, one of ordinary skill in the programming arts can appreciate that there are a variety of ways of making 
different function calls that achieve the same result. 

20 

B. REDEFINITION 

[0250] In some cases, it may be possible to ignore, add or redefine certain aspects (e.g., parameters) of a program- 
ming interface while still accomplishing the intended result. This is illustrated in Figs. 1 0 and 1 1 . For example, assume 

25 interface Interfacel of Fig. 6 includes a function call Square(input, precision, output), a call that includes three param- 
eters, input, precision and output, and which is issued from the 1 st Code Segment to the 2 nd Code Segment., If the 
middle parameter precision is of no concern in a given scenario, as shown in Fig. 10, it could just as well be ignored 
or even replaced with a meaningiess (in this situation) parameter. One may also add an additional parameter of no 
concern. In either event, the functionality of square can be achieved, so long as output is returned after input is squared 

30 by the second code segment. Precision may very well be a meaningful parameter to some downstream or other portion 
of the computing system; however, once it is recognized that precision is not necessary for the narrow purpose of 
calculating the square, it may be replaced or ignored. For example, instead of passing a valid precision value, a mean- 
ingless value such as a birth date could be passed without adversely affecting the result. Similarly, as shown in Fig. 
11 , interface 11 is replaced by interface 11', redefined to ignore or add parameters to the interface. Interface 12 may 

35 similarly be redefined as interface 12', redefined to ignore unnecessary parameters, or parameters that may be proc- 
essed elsewhere. The point here is that in some cases a programming interface may include aspects, such as param- 
eters, that are not needed for some purpose, and so they may be ignored or redefined, or processed elsewhere for 
other purposes. 

40 C. INLINE CODING 

[0251] It may also be feasible to merge some or all of the functionality of two separate code modules such that the 
"interface" between them changes form. For example, the functionality of Figs. 6 and 7 may be converted to the func- 
tionality of Figs. 12 and 13, respectively. In Fig. 12, the previous 1 st and 2 nd Code Segments of Fig. 6 are merged into 

45 a module containing both of them. In this case, the code segments may still be communicating with each other but the 
interface may be adapted to a form which is more suitable to the single module. Thus, for example, formal Call and 
Return statements may no longer be necessary, but similar processing or response(s) pursuant to interface Interfacel 
may still be in effect. Similarly, shown in Fig. 13, part (or all) of interface 12 from Fig. 7 may be written inline into interface 
11 to form interface 11". As illustrated, interface 12 is divided into I2a and I2b, and interface portion I2a has been coded 

50 in-line with interface 11 to form interface 11". For a concrete example, consider that the interface 11 from Fig. 7 performs 
a function call square {input, output), which is received by interface 12, which after processing the value passed with 
input (to square it) by the second code segment, passes back the squared result with output In such a case, the 
processing performed by the second code segment (squaring input) can be performed by the first code segment without 
a call to the interface. 

55 

D. DIVORCE 

[0252] A communication from one code segment to another may be accomplished indirectly by breaking the com- 
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munication into multiple discrete communications. This is depicted schematically in Figs. 14 and 15. As shown in Fig. 
1 4, one or more piece(s) of middleware (Divorce Interface(s). sincethey divorce functionality and / or interface functions 
from the original interface) are provided to convert the communications on the first interface, Interface 1 , to conform 
them to a different interface, in this case interfaces lnterface2A, lnterface2B and lnterface2C. This might be done, e. 

5 g., where there is an installed base of applications designed to communicate with, say, an operating system in accord- 
ance with an Interfacel protocol, but then the operating system is changed to use a different interface, in this case 
interfaces lnterface2A, lnterface2B and lnterface2C. The point is that the original interface used by the 2 nd Code Seg- 
ment is changed such that it is no longer compatible with the interface used by the 1 st Code Segment, and so an 
intermediary is used to make the old and new interfaces compatible. Similarly, as shown in Fig. 15, a third code segment 

10 can be introduced with divorce interface DM to receive the communications from interface 11 and with divorce interface 
DI2 to transmit the interface functionality to. for example, interfaces I2a and I2b, redesigned to work with DI2. but to 
provide the same functional result. Similarly, Dl 1 and DI2 may work together to translate the functionality of interfaces 
11 and 12 of Fig. 7 to a new operating system, while providing the same or similar functional result. 

15 E. REWRITING 

[0253] Yet another possible variant is to dynamically rewrite the code to replace the interface functionality with some- 
thing else but which achieves the same overall result. For example, there may be a system in which a code segment 
presented in an intermediate language (e.g. Microsoft IL Java ByteCode, etc.) is provided to a Just-in-Time (JIT) 

20 compiler or interpreter in an execution environment (such as that provided by the .Net framework, the Java runtime 
environment, or other similar runtime type environments). The JIT compiler may be written so as to dynamically convert 
the communications from the 1 st Code Segment to the 2 nd Code Segment, i.e.. to conform them to a different interface 
as may be required by the 2 nd Code Segment (either the original or a different 2 nd Code Segment). This is depicted in 
Figs. 1 6 and 1 7. As can be seen in Fig. 1 6, this approach is similar to the Divorce scenario described above. It might 

25 be done, e.g., where an installed base of applications are designed to communicate with an operating system in ac- 
cordance with an Interface 1 protocol but then the operating system is changed to use a different interface. The JIT 
Compiler could be used to conform the communications on the fly from the installed-base applications to the new 
interface of the operating system. As depicted in Fig. 17, this approach of dynamically rewriting the interface(s) may 
be applied to dynamically factor, or otherwise alter the interface(s) as well. 

30 [0254] It is also noted that the above-described scenarios for achieving the same or similar result as an interface via 
alternative embodiments may also be combined in various ways, serially and/or in parallel, or with other intervening 
code. Thus, the alternative embodiments presented above are not mutually exclusive and may be mixed, matched and 
combined to produce the same or equivalent scenarios to the generic scenarios presented in Figs. 6 and 7. It is also 
noted that, as with most programming constructs, there are other similar ways of achieving the same or similar func- 

35 tionality of an interface which may not be described herein, but nonetheless are represented by the spirit and scope 
of the invention, i.e., it is noted that it is at least partly the functionality represented by, and the advantageous results 
enabled by, an interface that underlie the value of an interface. 

Conclusion 

40 

[0255] Although the invention has been described in language specific to structural features and/or methodological 
acts, it is to be understood that the invention defined in the appended claims is not necessarily limited to the specific 
features or acts described. Rather, the specific features and acts are disclosed as exemplary forms of implementing 
the claimed invention. 

45 

Claims 

1 . A programming interface embodied on one or more computer readable media, comprising: 

50 

a first group of types related to core file system concepts; 
a second group of types related to entities that a human being can contact; 
a third group of types related to documents; 
a fourth group of types common to multiple kinds of media; 
55 a fifth group of types specific to audio media; 

a sixth group of types specific to video media; 

a seventh group of types specific to image media; 

an eighth group of types specific to electronic mail messages; and 
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a ninth group of types related to identifying particular locations. 
A programming interface as recited in claim 1 , further comprising: 

a tenth group of types related to moving data between file systems. 
A programming interface as recited in claim 1 , further comprising: 

a tenth group of types related to creating and managing rules for generating notifications. 
A programming interface as recited in claim 1 , further comprising: 

a tenth group of types describing types defined in all the other groups of types. 
A programming interface as recited in claim 1 , further comprising: 

a tenth group of types related to base types that form a foundation to support all the other groups of types. 

A programming interface as recited in claim 1 , further comprising: 

a tenth group of types common to multiple kinds of messages, including the electronic mail messages; and 
an eleventh group of types specific to facsimile messages. 

A programming interface as recited in claim 1 , further comprising: 

a tenth group of types related to annotations; and 
an eleventh group of types related to notes; 

A programming interface as recited in claim 1 , further comprising: 

a tenth group of types related to installed programs; and 
an eleventh group of types related to installed games. 

A programming interface as recited in claim 1 , further comprising: 

a tenth group of types related to actions taken by a user; and 

an eleventh group of types related to maintaining and accessing help information. 

A programming interface as recited in claim 1 , further comprising: 

a tenth group of types related to a natural language search engine. 

A programming interface as recited in claim 1 , further comprising: 

a tenth group of types related to tasks in a user interface to let a user know what actions the user can perform 
when navigating the user interface. 

A programming interface as recited in claim 1 , further comprising: 

a tenth group of types related to user tasks. 
A programming interface as recited in claim 1 , further comprising: 

a tenth group of types related to services that can be accessed. 
A programming interface as recited in claim 13, wherein the services can be accessed over a network. 
A programming interface as recited in claim 1 , further comprising: 



64 



EP 1 526 452 A2 

a tenth group of types related to identifying access rights. 

16. A programming interface as recited in claim 1 , further comprising: 

a tenth group of types related to calendar types. 

17. A programming interface as recited in claim 1 , further comprising: 

a tenth group of types related to creating and managing event monitoring and resultant actions. 

18. A programming interface as recited in claim 1 , further comprising: 

a tenth group of types used for interop for each of the first through ninth groups of types. 

19. A programming interface as recited in claim 1 , further comprising: 

an additional group of types for each of the first through ninth groups of bytes, wherein each of the additional 
groups of types are for interop. 

20. A programming interface as recited in claim 1 , further comprising: 

a tenth group of types related to files stored in a file system. 

21 . A programming interface as recited in claim 1 , further comprising: 

a tenth group of types related to a category hierarchy. 

22. A system comprising: 

means for exposing a first set of functions that represent core concepts of a file system of the system; 
means for exposing a second set of functions that enable maintaining information regarding entities that can 
be contacted; and 

means for exposing a third set of functions that allow document types to be accessed. 

23. A system as recited in claim 22, further comprising 

means for exposing a fourth set of functions related to base types for a plurality of kinds of media; 
means for exposing a fifth set of functions related specifically to audio media; and 
means for exposing a sixth set of functions related specifically to video media. 

24. A system as recited in claim 23, further comprising: 

means for exposing a seventh set of functions related specifically to image media. 

25. A system as recited in claim 22, further comprising 

means for exposing a fourth set of functions related specifically to electronic mail messages. 

26. A system as recited in claim 22, further comprising 

means for exposing a fourth set of functions that enable maintaining physical location information. 

27. A method of organizing a set of types for a file system into a hierarchical namespace comprising: 

creating a plurality of groups from the set of types ; each group containing at least one type that exposes 
logically related functionality; 

assigning a name to each group in the plurality, wherein one of the groups in the plurality includes functionality 
related to core concepts of the file system, wherein another of the groups in the plurality includes functionality 
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related to entities that a human being can contact, wherein another of the groups in the plurality includes 
functionality related to document types that can be stored in the file system, and wherein another of the groups 
in the plurality includes functionality related to multiple kinds of media; and 

selecting a top level identifier and prefixing the name of each group with the top level identifier so that the 
5 types in each group are referenced by a hierarchical namethat includes the selected top level identifier prefixed 

to the name of the group containing the type. 

28. A method as recited in claim 27, wherein another of the groups in the plurality includes functionality particularly 
for audio media, wherein another of the groups in the plurality includes functionality particularly for video media, 

10 and wherein another of the groups in the plurality includes functionality particularly for image media. 

29. A method as recited in claim 27, wherein another of the groups in the plurality includes functionality related to 
electronic mail. 

15 30. A method as recited in claim 27, wherein another of the groups in the plurality includes functionality related to 
maintaining physical location information. 

31. A method as recited in claim 27, wherein the assigning comprises: 

20 assigning a name of Core to the group that includes functionality related to core concepts of the file system 

so that the hierarchical name for the group that includes functionality related to core concepts of the file system 
is System. Storage. Core; 

assigning a name of Contacts to the group that includes functionality related to entities that a human being 
can contact so that the hierarchical name for the group that includes functionality related to entities that a 

25 human being can contact is System. Storage. Contacts; 

assigning a name of Documents to the group that includes functionality related to document types that can 
be stored in the file system so that the hierarchical name for the group that includes functionality related to 
document types that can be stored in the file system is System. Storage. Documents; and 
assigning a name of Media to the group that includes functionality related to multiple kinds of media so that 

30 the hierarchical name for the group that includes functionality related to multiple kinds of media is System. 

Storage. Media. 

32. A method as recited in claim 27, wherein the assigning comprises: 

35 assigning a name of Core to the group that includes functionality related to core concepts of the file system 

so that the hierarchical name for the group that includes functionality related to core concepts of the file system 
is System. Storage. Core; 

assigning a name of Contact to the group that includes functionality related to entities that a human being can 
contact so that the hierarchical name for the group that includes functionality related to entities that a human 
40 being can contact is System. Storage. Contact; 

assigning a name of Document to the group that includes functionality related to document types that can be 
stored in the file system so that the hierarchical name for the group that includes functionality related to doc- 
ument types that can be stored in the file system is System. Storage. Document; and 

assigning a name of Media to the group that includes functionality related to multiple kinds of media so that 
45 the hierarchical name for the group that includes functionality related to multiple kinds of media is System. 

Storage. Media. 

33. A method, comprising: 

50 creating a first namespace with functions that enable identification of particular physical locations; and 

creating a second namespace with functions that enable identification of entities that can be contacted by a 
human being. 

34. A method as recited in claim 33, further comprising: 

55 

creating a third namespace with functions that enable documents to be described. 

35. A method as recited in claim 33, further comprising: 
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creating a third namespace with functions specific to electronic mail messages. 

36. A method as recited in claim 33, further comprising: 

5 creating a third namespace with functions common to multiple kinds of media; 

creating a fourth namespace with functions specific to audio media; 
creating a fifth namespace with functions specific to video media; and 
creating a sixth namespace with functions specific to image media. 

10 37. A method as recited in claim 33, further comprising: 

creating a third namespace with functions that are expected to be used by all other namespaces. 

38. One or more computer readable media having stored thereon a plurality of instructions that, when executed by a 
15 processor, cause the processor to: 

create a first namespace with functions that enable identification of particular physical locations; and 
create a second namespace with functions that are expected to be used by the first namespace and a plurality 
of additional namespaces. 

20 

39. One or more computer readable media as recited in claim 38, wherein the instructions further cause the processor 
to: 

create a third namespace with functions that enable documents to be described; 
25 create a fourth namespace with functions that enable identification of entities that can be contacted by a human 

being; and 

create a fifth namespace with functions common to multiple kinds of media. 

40. One or more computer readable media as recited in claim 39, wherein the instructions further cause the processor 

30 to: 

create a sixth namespace with functions specific to audio media; 
create a seventh namespace with functions specific to video media; and 
create an eighth namespace with functions specific to image media. 

35 

41 . One or more computer readable media as recited in claim 38, wherein the instructions further cause the processor 
to: 

create a third namespace with functions common to multiple kinds of media; 
40 create a fourth namespace with functions specific to audio media; 

create a fifth namespace with functions specific to video media; and 
create a sixth namespace with functions specific to image media. 

42. A method comprising: 

45 

calling one or more first functions that enable documents to be described; and 

calling one or more second functions that are core functions expected to be used by the one or more first 
functions as well as a plurality of additional functions. 

50 43. A method as recited in claim 42, further comprising: 

calling one or more third functions common to multiple kinds of media. 

44. A method as recited in claim 43, further comprising: 

55 

calling one or more fourth functions specific to audio media; 
calling one or more fifth functions specific to video media; and 
calling one or more sixth functions specific to image media. 
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45. A method as recited in claim 42, further comprising: 

calling one or more third functions that enable identification of entities that can be contacted by a human being; 
and 

5 calling one or more fourth functions that enable identification of particular physical locations. 

46. A method as recited in claim 42, further comprising: 

calling one or more third functions specific to electronic mail messages. 

10 

47. A method, comprising: 

receiving one or more calls to one or more first functions that enable identification of entities that can be 
contacted by a human being; and 
15 receiving one or more calls to one or more second functions that are core functions expected to be used by 

the one or more first functions as well as a plurality of additional functions. 

48. A method as recited in claim 47, further comprising: 

20 receiving one or more calls to one or more third functions that enable documents to be described; 

receiving one or more calls to one or more fourth functions common to multiple kinds of media; and 
receiving one or more calls to one or more fifth functions that enable identification of particular physical loca- 
tions. 

25 49. a method as recited in claim 48, further comprising: 

receiving one or more calls to one or more sixth functions specific to audio media; 
receiving one or more calls to one or more seventh functions specific to video media; and 
receiving one or more calls to one or more eighth functions specific to image media. 
30 receiving one or more calls to one or more ninth functions specific to electronic mail messages. 

50. One or more computer readable media having stored thereon a plurality of instructions that, when executed by a 
processor, cause the processor to: 

35 rece jve one or more calls to one or more first functions that enable identification of entities that can be contacted 

by a human being; and 

receive one or more calls to one or more second functions common to multiple kinds of media. 

51 . One or more computer readable media as recited in claim 50, wherein the instructions further cause the processor 
40 to: 

receive one or more calls to one or more third functions that are core functions expected to be used by the 
one or more first functions, the one or more second functions, and a plurality of additional functions. 

^5 52. One or more computer readable media as recited in claim 50, wherein the instructions further cause the processor 
to: 

receive one or more calls to one or morethird functions that enable identification of particular physical locations; 
receive one or more calls to one or more fourth functions that enable documents to be described; and 
50 receive one or more calls to one or more fifth functions specific to electronic mail messages. 

53. One or more computer readable media as recited in claim 50, wherein the instructions further cause the processor 

to: 

55 receive one or more calls to one or more third functions specific to audio media; 

receive one or more calls to one or more fourth functions specific to video media; and 
receive one or more calls to one or more fifth functions specific to image media. 
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